Express 项目环境搭建 -- 14. 配置与环境变量

目录结构定了之后,下一个问题是配置:数据库地址、密钥、端口这些因环境而异的值,不能写死在代码里。把它们抽到环境变量,代码只负责读取。

为什么用环境变量

  • 同一份代码在开发、测试、生产环境用不同配置,无需改代码。
  • 密钥、密码不进入 git,降低泄露风险。
  • 部署平台(容器、PaaS)通常通过环境变量注入配置。

用 dotenv 读取 .env

1
npm install dotenv
1
2
3
4
5
6
7
8
// src/config/index.js
require("dotenv").config();

module.exports = {
port: process.env.PORT || 3000,
databaseUrl: process.env.DATABASE_URL,
jwtSecret: process.env.JWT_SECRET
};

在应用启动时调用一次 config 模块即可。dotenv v18 起还提供 CLI 方式,不改代码也能加载:

1
npx dotenv run -- node bin/www

区分环境

常见做法是准备多份文件,按 NODE_ENV 选择:

1
2
3
.env                # 公共配置
.env.development # 开发环境
.env.production # 生产环境
1
require("dotenv").config({ path: `.env.${process.env.NODE_ENV || "development"}` });

注意加载顺序:先加载 .env,再加载环境专属文件覆盖同名变量。

启动时校验必需变量

缺少关键配置时,与其运行到一半才报错,不如启动就失败:

1
2
3
4
5
6
const required = ["DATABASE_URL", "JWT_SECRET"];
for (const key of required) {
if (!process.env[key]) {
throw new Error(`缺少必需的环境变量: ${key}`);
}
}

提供 .env.example

把变量名写进模板并提交到 git,真实值放在 .env 并加入 .gitignore:

1
2
# .gitignore
.env
1
2
3
4
# .env.example
PORT=3000
DATABASE_URL=
JWT_SECRET=

新人或 AI 助手拿到仓库,照着 .env.example 填值即可运行。

参考链接

系列导航


Express 项目环境搭建 -- 14. 配置与环境变量
https://bubao.github.io/posts/2b3c4d5e.html
作者
一念
发布于
2026年11月21日
许可协议