Express 项目环境搭建 -- 14. 配置与环境变量
目录结构定了之后,下一个问题是配置:数据库地址、密钥、端口这些因环境而异的值,不能写死在代码里。把它们抽到环境变量,代码只负责读取。
为什么用环境变量
- 同一份代码在开发、测试、生产环境用不同配置,无需改代码。
- 密钥、密码不进入 git,降低泄露风险。
- 部署平台(容器、PaaS)通常通过环境变量注入配置。
用 dotenv 读取 .env
1 | |
1 | |
在应用启动时调用一次 config 模块即可。dotenv v18 起还提供 CLI 方式,不改代码也能加载:
1 | |
区分环境
常见做法是准备多份文件,按 NODE_ENV 选择:
1 | |
1 | |
注意加载顺序:先加载 .env,再加载环境专属文件覆盖同名变量。
启动时校验必需变量
缺少关键配置时,与其运行到一半才报错,不如启动就失败:
1 | |
提供 .env.example
把变量名写进模板并提交到 git,真实值放在 .env 并加入 .gitignore:
1 | |
1 | |
新人或 AI 助手拿到仓库,照着 .env.example 填值即可运行。
参考链接
系列导航
Express 项目环境搭建 -- 14. 配置与环境变量
https://bubao.github.io/posts/2b3c4d5e.html
