dotenv

dotenv 是将 .env 文件加载到环境变量的库与约定，Node.js 生态最流行，实现配置外置。

用途

使本地开发能用 .env 文件管理配置，生产用真实环境变量，代码无需修改。

机制

启动时读取 .env 文件，解析 KEY=VALUE，注入 process.env。支持多环境（.env.development）、变量插值（$VAR）、引号处理。不覆盖已存在的环境变量（除非 override）。

用例

Node.js 项目本地配置
Next.js/Vite 环境变量
Docker Compose env_file 环境注入
测试环境隔离

示例

输入

.env: API_KEY=secret

输出

process.env.API_KEY="secret"

Loaded into the environment

常见错误

Loading dotenv in production wastes startup time: Use real environment variables in production and do not load .env

相关词条

ENV 文件用 KEY=VALUE 格式定义环境变量，用于应用配置，12-factor 应用推荐方式。

INI 是传统的配置文件格式，用 [section] 分组与 key=value 键值对，简单但无标准，各实现语法略有差异。

Java Properties 文件用 KEY=VALUE 或 KEY:VALUE 格式，Java 生态传统配置格式，支持 Unicode 转义。

相关工具

将 .env 风格的 KEY=VALUE 行解析为 JSON。空行与「#」开头的注释会被跳过。其余 dotenv 约定未实现：「export 」前缀会保留在键名中（export PORT=3000 → “export PORT”），值周围的引号也会原样保留。

ENV 序列化器

ENV Stringify — 纯客户端工具。隐私优先，无服务器往返。

Json To Env — 纯客户端工具。隐私优先，无服务器往返。

Yaml To Env — 纯客户端工具。隐私优先，无服务器往返。

参考链接