新版Node.js内置支持.env文件使用详解
作者:FEDLAB
引言
随着版本 v20.6.0 的发布,Node.js 现在内置了对.env文件的支持。现在,您可以完全无依赖地将环境变量从.env文件加载到Node.js 应用程序中。process.env 加载.env文件现在非常简单:
node --env-file .env
1.什么是.env 文件?
.env文件用于配置正在运行的应用程序中存在的环境变量。这个想法来自“The Twelve-Factor App”方法论,该方法论表示将在环境中的部署(例如开发、测试、生产)之间可能发生变化的所有内容存储起来。
配置不应成为应用程序代码的一部分,也不应签入版本控制。API 凭证或其他机密等内容应单独存储并加载到需要它们的环境中。文件.env可让您管理无法在环境中设置变量的应用程序的配置,例如开发计算机或CI。
许多不同语言的库都支持使用.env文件将变量加载到环境中,它们通常称为“dotenv”,Node.js常用的NPM包有 cross-env
, dotenv
.
2.如何使用 .env 文件?
一个.env文件看起来长这样:
# 开发环境 .env.development NODE_ENV=development SECRET_KEY=rv3O62d1gu7s8vWpx
通用我们会将.env文件放置到项目的根目录中,可以自定义文件命名,通过 --env-file
参数指定 .env 文件,待 Node.js 程序启动后,就可以从 process.env
中获取最新的环境变量。
$ node --env-file .env.development Welcome to Node.js v20.6.0. Type ".help" for more information. > console.log(process.env.NODE_ENV, process.env.SECRET_KEY) development rv3O62d1gu7s8vWpx >
3.与 dotenv 对比
和dotenv相比,.env 文件支持的功能还相当基础。主要表现如下:
- 您当前无法使用多行值
- 不能使用变量扩展
- 您一次只能指定一个文件。Node.js 将仅使用最后传递的 .env 文件,如下示例中,仅使用 .env.production 的变量:
$ node --env-file .env.development --env-file .env.production Welcome to Node.js v20.6.0. Type ".help" for more information. > console.log(process.env.NODE_ENV, process.env.SECRET_KEY) production grv3O62d1gu7s8vWpd
- 如果在环境和文件中定义了相同的变量,则环境中的值优先,Node.js 中 .env 的实现并非如此,而是会将环境中的覆盖掉。
随着 Node.js 版本迭代,.env 文件的特性支持还有很多工作要完善,并且可能会添加其中一些功能。您可以点击左下角的“阅读原文”查看 Github 上更多讨论。
4.Node.js 实现的优势
尽管这种实现方式缺少一些功能,但与使用第三方软件包相比,它还是有一些优势。Node.js 会在启动时加载并解析 .env 文件,因此你可以在文件中加入配置 Node.js 本身的环境变量,如 NODE_OPTIONS。
NODE_OPTIONS="--no-warnings --inspect=127.0.0.1:9229"
注意:为了避免死循环,不要在 NODE_OPTIONS="--env-file .env.develpment" 配置你的 .env 文件。
总结
大家可以积极去尝试 Node.js 20.6.0 版本带来的新功能,如稳定的测试运行器、模拟计时器和现在的 .env 文件支持,以及许多其他升级、修复和改进。20版本将于10月份成为 Node.js 的 LTS 版本,因此现在是测试这些新功能并开始考虑升级应用程序以利用这些新功能的好时机。
以上就是新版Node.js内置支持.env文件使用详解的详细内容,更多关于Node.js内置.env文件的资料请关注脚本之家其它相关文章!