抛弃 dotenv：Nodejs 现在原生支持 env 文件加载

node.js 环境管理的主要内容之一是使用 dotenv 包，它有助于从 .env 文件加载环境变量。然而，node.js 最近的更新引入了内置功能，可以减少或消除对 dotenv 等外部包来管理环境变量的需求。

本机 .env 文件处理

从版本 20.6.0 开始，node.js 允许在执行脚本时使用 --env-file 标志。此标志指定 node.js 在运行指定脚本之前将读取的 .env 文件的路径。这种方法简化了设置环境变量的过程，使其更加集成并且更少依赖第三方包。

考虑一个场景，您具有以下环境配置：

# .env file
node_options='--title="sample node app"'
user_name='john doe'

要使用此配置运行 node.js 脚本，您可以使用：

node --env-file=.env your-script.js

在 your-script.js 中，可以按如下方式访问这些变量：

console.log(process.title); // outputs: sample node app
console.log(`hello, ${process.env.user_name}`); // outputs: hello, john doe

使用 process.loadenvfile() 简化加载

在最初的支持基础上，node.js 版本 21.7.0 引入了 process.loadenvfile() 方法。此函数通过将环境变量合并到运行时进程中来简化环境变量的加载，而不需要命令行标志。

您可以在应用程序中以编程方式加载环境变量，如下所示：

process.loadenvfile(); // automatically loads `.env` from the current directory
​
// or specify a path
process.loadenvfile('./config/env_vars.env');

解析环境变量

除了加载环境变量之外，node.js 21.7.0 还引入了 util.parseenv()，这是一个实用函数，可将包含环境变量定义的字符串解析为对象。

以下是如何使用 util.parseenv():

const util = require('node:util');
const envvars = util.parseenv('api_key=12345');
console.log(envvars.api_key); // outputs: 12345

支持 .env 文件中的多行值

node.js 21.7.0 中的另一个功能是支持 .env 文件中的多行值：

CERTIFICATE="-----BEGIN CERTIFICATE-----
MIIDdTCCAl2gAwIBAgIJAKC1hi9s2wfMM...
-----END CERTIFICATE-----"

您现在可以直接在 .env 文件中包含此类多行字符串，从而使复杂配置的管理更加清晰、更加直接。

结论

最新 node.js 中引入的原生 .env 文件支持可以让您的项目更快地设置，并减少对 dotenv 等外部包的依赖。

如果您发现这有帮助，请考虑 订阅我的时事通讯 以获取更多有关 web 开发的有用文章和工具。感谢您的阅读！