环境变量与配置

这一课你将能做到

1. 用 process.env 读取环境变量，并说明它「全字符串、按进程隔离」的两个特性
2. 用 node --env-file 或 dotenv 加载 .env 文件，把密钥、端口从代码里彻底挪出去
3. 搭一个按环境（dev/test/prod）切换配置的 config 模块，并知道哪些文件绝不能提交 git

为什么要学

代码里写死 const dbPassword = 'admin123' 会发生什么？提交 git 就是公开处刑——爬虫扫到你的仓库，密码几小时内就会被尝试连接。行业解法是 12-Factor 的配置分离原则：代码同一份，配置按环境注入，密钥只存在于部署环境里。

人话：环境变量就是「操作系统级别的小储物柜」，你启动进程前把值放进去，进程用 process.env 取。开发时值在 .env 文件里（不提交 git），生产时值在部署平台的配置面板里。这课内容不多，但它是所有真实项目的「入场券」——不会这课，项目连安全地放到 GitHub 上都做不到。

先建立图像

┌─ 开发环境 ─────────────────────────────┐
│  .env 文件（git 忽略）                  │
│    PORT=3000                           │
│    DB_HOST=localhost                   │
│  启动: node --env-file=.env server.js  │
│         └──► 注入 process.env          │
└────────────────────────────────────────┘
┌─ 生产环境 ─────────────────────────────┐
│  部署平台配置面板 / CI 变量 / K8s Secret│
│  （同样注入 process.env，代码零改动）    │
└────────────────────────────────────────┘

代码里只写: const port = Number(process.env.PORT ?? 3000)

同一份代码，值从外面来——这就是「配置与代码分离」。

跟着做

步骤 1：认识 process.env

新建 node-env 目录，npm init -y，新建 show-env.js：

// show-env.js
console.log('系统 PATH 存在吗:', Boolean(process.env.PATH));
console.log('当前用户(Windows):', process.env.USERNAME);
console.log('自定义变量 MY_FLAG:', process.env.MY_FLAG);   // 没设置就是 undefined
console.log('PORT 原始值:', JSON.stringify(process.env.PORT));

终端里先注入再运行（PowerShell）：

$env:PORT="3000"; node show-env.js
# 自定义变量 MY_FLAG: undefined
# PORT 原始值: "3000"      ← 注意是字符串，带引号！

Linux/macOS（bash）写法：

PORT=3000 MY_FLAG=1 node show-env.js

两个铁律当场验证：没设置的变量是 undefined；设置的值永远是字符串（"3000" 不是 3000）。

步骤 2：写一个健壮的取值工具

新建 env.js：

// env.js —— 把"取环境变量 + 类型转换 + 默认值"收编成三个小函数
function envStr(key, defaultValue) {
  const v = process.env[key];
  return v === undefined || v === '' ? defaultValue : v;
}

function envInt(key, defaultValue) {
  const v = Number.parseInt(process.env[key] ?? '', 10);
  return Number.isNaN(v) ? defaultValue : v;
}

function envBool(key, defaultValue) {
  const v = process.env[key];
  if (v === undefined) return defaultValue;
  return v === '1' || v.toLowerCase() === 'true';
}

module.exports = { envStr, envInt, envBool };