Node.js 解释环境变量的定义、作用及在Node.js中的重要性，区分开发、测试、生产环境配置需求。

cdming2025-11-06 22:18

环境变量基础概念

解释环境变量的定义、作用及在Node.js中的重要性，区分开发、测试、生产环境配置需求。

常见配置方式

process.env与系统环境变量

Node.js通过process.env访问系统环境变量，演示如何通过命令行临时设置变量（如PORT=3000 node app.js）。

.env文件与dotenv库

使用dotenv库加载.env文件，示例代码：

复制代码

require('dotenv').config();
console.log(process.env.DB_HOST);

说明文件格式（如DB_HOST=localhost）及安全注意事项（避免提交到版本控制）。

动态配置策略

多环境适配

根据NODE_ENV切换配置，示例逻辑：

复制代码

const config = {
  development: { dbUrl: 'dev-db-url' },
  production: { dbUrl: process.env.PROD_DB_URL }
};
const env = process.env.NODE_ENV || 'development';
module.exports = config[env];

校验与默认值

使用envalid库验证变量是否存在或格式正确，示例：

复制代码

const { cleanEnv, str } = require('envalid');
cleanEnv(process.env, {
  API_KEY: str(),
  PORT: port({ default: 3000 })
});

部署与安全实践

容器化部署（Docker）

演示在Docker中传递环境变量：

复制代码

ENV NODE_ENV=production
CMD ["node", "app.js"]

或通过docker run -e "KEY=value"动态注入。

敏感信息管理

推荐使用AWS Secrets Manager或Vault等工具，避免硬编码密钥。

调试与问题排查

列出常见错误（如变量未加载、拼写错误），提供console.log(process.env)调试技巧及cross-env跨平台设置变量的方法。

工具与扩展推荐

对比dotenv-expand（变量扩展）、config（统一配置管理）等工具的适用场景，附官方文档链接。

注：实际写作时可扩展每部分的代码示例、流程图（如配置加载流程）及安全审计建议。