Node.js环境变量配置实战技术文章大纲

环境变量的概念与作用

• 环境变量的定义及其在开发和生产环境中的重要性
• 常见使用场景：数据库连接、API密钥、服务端口配置
• 环境变量与硬编码的对比，强调安全性与灵活性

Node.js中环境变量的基本使用

• process.env对象的基本用法
• 在代码中直接访问环境变量

  const apiKey = process.env.API_KEY;
  

• 命令行临时设置环境变量

  API_KEY=12345 node app.js
  

使用.env文件管理环境变量

• 安装dotenv库

  npm install dotenv
  

• 创建.env文件并定义变量

  DB_HOST=localhost
  DB_USER=root
  DB_PASS=password
  

• 在Node.js中加载.env文件

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

环境变量在不同环境的差异化配置

• 为开发、测试和生产环境创建独立的.env文件（.env.development、.env.production）
• 通过NODE_ENV动态加载环境配置

  const env = process.env.NODE_ENV || 'development';
  require('dotenv').config({ path: `.env.${env}` });
  

安全性与最佳实践

• 避免将.env文件提交到版本控制系统（通过.gitignore排除）
• 在CI/CD流程中通过密钥管理工具注入环境变量
• 使用dotenv-safe或envalid进行环境变量校验

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

与流行框架的集成

• Express.js中的环境变量配置示例
• NestJS和Fastify框架的环境变量管理方案
• 通过Docker和Kubernetes部署时的环境变量传递方式

常见问题与调试技巧

• 环境变量未加载的可能原因及排查方法
• 跨平台环境变量兼容性问题（Windows vs. Unix）
• 使用debug模块输出环境变量调试信息

进阶工具与扩展

• 使用cross-env实现跨平台环境变量设置

  cross-env NODE_ENV=production node app.js
  

• 动态环境变量与配置中心（如Consul、Vault）的集成
• 环境变量加密与解密方案