Node.js中的环境变量是什么？
环境变量是一组在操作系统级别定义的、供应用程序使用的动态值。在Node.js应用中，它们通常用于存储不应该被硬编码到代码中的配置信息，例如：
- 数据库连接字符串
- API密钥和凭证
- 端口号
- 服务域名或URL
- 日志级别
- 当前运行环境（开发、测试、生产）
Node.js通过全局的 process.env 对象暴露这些环境变量。无论变量是在操作系统启动时设置的，还是在运行Node.js进程之前设置的，都可以在你的Node.js代码中通过 process.env.YOUR_VARIABLE_NAME 的形式访问到。需要注意的是，process.env 对象中的所有值都是字符串类型。
为什么需要使用环境变量？
使用环境变量而非直接在代码中硬编码配置信息，是构建现代、可维护和安全的应用程序的关键实践。其核心原因包括：
分离配置与代码
将配置信息（如数据库凭据、API密钥）从代码中分离出来，使得代码本身可以在不同环境（开发、测试、生产）中复用，而无需修改。只需要更改环境变量即可。这遵循了“配置外化”的原则，是Twelve-Factor App方法论的重要组成部分。
环境特定设置
同一个应用程序在不同的运行环境中往往需要不同的配置。例如，开发环境可能连接本地数据库，生产环境连接云数据库；开发环境开启详细日志，生产环境只记录错误。环境变量是区分这些环境特定设置的标准方式。
安全考虑
敏感信息如数据库密码、API密钥如果硬编码在代码中，一旦代码库泄露（即使是私有仓库也存在风险），这些凭证也会随之泄露。将这些信息存储在环境变量中，可以在部署时不将它们包含在应用程序包内部，而是由运行环境提供，大大提高了安全性。此外，环境变量不会被意外地提交到版本控制系统中。
简化部署
当应用程序被部署到不同的服务器或容器中时，无需修改代码或重新构建镜像，只需在目标环境中设置相应的环境变量即可启动应用。这使得部署过程更加灵活和自动化。
环境变量在哪里配置和访问？
环境变量的配置和访问发生在不同的层面：
配置的“哪里”：环境变量的来源
环境变量可以在多种地方被设置：
-
操作系统或Shell：
在启动Node.js进程之前，可以在操作系统的命令行环境中设置临时或永久的环境变量。
Linux/macOS:export MY_VAR=my_value或在~/.bashrc,~/.zshrc等文件中设置。
Windows (Command Prompt):set MY_VAR=my_value
Windows (PowerShell):$env:MY_VAR="my_value" -
.env 文件：
一个位于项目根目录下的普通文本文件，用于存放键值对形式的环境变量。这是一种非常流行的本地开发方式，需要借助第三方库（如 dotenv）来加载。 -
进程管理器：
使用PM2、forever等进程管理器运行时，可以在其配置文件中指定环境变量。 -
容器化平台：
使用Docker时，可以在Dockerfile或docker-compose文件中通过ENV指令或environment字段设置环境变量。 -
云部署平台：
各种云服务（如Heroku, AWS Elastic Beanstalk, Netlify, Vercel, Azure App Services）都提供了界面或CLI工具来为部署的应用设置环境变量，这些变量会在应用启动时注入到运行环境中。
访问的“哪里”：Node.js代码内部
在Node.js应用程序的任何地方，都可以通过全局对象 process.env 来访问当前运行环境下的环境变量。这是一个简单的JavaScript对象，其属性名即为环境变量的名称，属性值即为对应的值。
示例：
假设环境变量 PORT 被设置为 3000，在Node.js代码中你可以这样访问：
const port = process.env.PORT; // port 的值是字符串 "3000"
环境变量的数量和管理？
关于环境变量的“多少”，并没有一个严格的技术限制规定你最多能设置多少个环境变量或它们的值有多大。然而，从实践和管理角度来看，过多的环境变量会增加配置的复杂性，难以追踪和维护。
- 数量： 尽量保持环境变量的数量合理，只包含必要的配置信息。相关的配置项可以考虑组合（例如，一个数据库URL变量包含所有连接信息，而不是分开的host, user, password变量，但要注意安全性）。
- 值的大小： 大多数操作系统对单个环境变量的值或所有环境变量的总大小有限制，但这通常远大于常规配置信息的需求。避免在环境变量中存储非常大的数据块。
-
管理：
随着应用规模和环境数量的增加，有效管理环境变量变得重要。- 使用 .env 文件加 dotenv 库是本地开发的首选。
- 在部署流程中，利用平台的内置功能集中管理各环境的变量。
- 对于高度敏感的信息（如生产环境数据库密码），考虑使用专门的秘密管理系统（如AWS Secrets Manager, HashiCorp Vault）而非简单的环境变量。
- 使用配置加载库，这些库可以从环境变量、文件、命令行参数等多种来源加载配置，并提供验证、默认值等功能。
如何在Node.js中配置和使用环境变量？
这是最核心的部分，我们将详细介绍几种常见的方法。
方法一：通过Shell命令行设置（临时）
这是最直接的方式，在启动Node.js进程的同一行命令中设置环境变量。
Linux/macOS:
PORT=3000 NODE_ENV=development node index.js
(这里，PORT=3000 和 NODE_ENV=development 只对紧随其后的 node index.js 命令有效)
Windows (Command Prompt):
set PORT=3000&&set NODE_ENV=development&&node index.js
(使用 && 连接命令)
Windows (PowerShell):
$env:PORT=3000;$env:NODE_ENV="development";node index.js
(使用 ; 连接命令)
在Node.js代码中访问：
console.log(process.env.PORT); // 输出 "3000"
console.log(process.env.NODE_ENV); // 输出 "development"
优点： 简单直观，无需额外工具。
缺点： 变量多时命令行变得很长，不适合存储大量配置，尤其不适合用于生产环境（除非通过脚本自动化）。
方法二：使用.env文件和dotenv库
这是本地开发中最推荐的方式。
第一步：创建.env文件
在项目根目录创建名为 .env 的文件（注意前面的点）。文件内容是键值对，格式为 KEY=VALUE，每行一个变量。
示例：
.env 文件内容：
DB_HOST=localhost
DB_USER=myuser
DB_PASSWORD=mypassword123
API_KEY=your_api_key_here
PORT=5000
NODE_ENV=development
重要： 将 .env 文件添加到你的版本控制系统的忽略列表（如 .gitignore），避免泄露敏感信息。
第二步：安装dotenv库
在项目目录中运行npm或yarn安装 dotenv 包。
npm install dotenv
或者
yarn add dotenv
第三步：在应用入口文件顶部引入并配置dotenv
在你的主文件（通常是 index.js 或 server.js）的顶部，尽早引入并调用 config() 方法。
示例 (index.js):
// 在应用启动时尽快加载环境变量
require('dotenv').config();
// 现在可以访问 process.env 中从 .env 文件加载的变量了
const dbHost = process.env.DB_HOST;
const dbUser = process.env.DB_USER;
const dbPassword = process.env.DB_PASSWORD;
const port = process.env.PORT || 3000; // 提供一个默认值
const env = process.env.NODE_ENV || 'production'; // 提供一个默认值
console.log(`Database Host: ${dbHost}`);
console.log(`Environment: ${env}`);
console.log(`Server running on port ${port}`);
// ... 应用的其他代码 ...
当 require('dotenv').config() 被调用时，它会查找项目根目录下的 .env 文件，并将文件中定义的所有键值对加载到 process.env 对象中。如果 process.env 中已经存在同名的变量，dotenv 不会覆盖它，这允许你通过Shell命令行覆盖 .env 文件中的值。
优点： 集中管理本地开发配置，不污染操作系统环境变量，方便与团队成员共享非敏感配置模板（通过 .env.example 文件）。
缺点： .env 文件本身不安全，不适合存储生产环境的秘密。需要额外安装库。
方法三：通过进程管理器或部署平台设置
在生产环境中，通常不会手动使用Shell命令或依赖客户端加载 .env 文件。进程管理器和部署平台提供了更健壮的方式。
使用PM2
PM2 是一个常用的Node.js进程管理器，它允许你在配置文件中指定环境变量。
示例 (ecosystem.config.js):
module.exports = {
apps : [{
name: "my-app",
script: "index.js",
env: {
NODE_ENV: "development",
PORT: 3000,
DB_HOST: "localhost"
},
env_production: {
NODE_ENV: "production",
PORT: 80,
DB_HOST: "prod.db.example.com"
}
}]
};
然后通过 pm2 start ecosystem.config.js --env production 启动应用，PM2 会自动加载 env_production 下的环境变量到进程中。
使用Docker
在Docker中，可以在Dockerfile中使用 ENV 指令，或在 docker run 命令中使用 -e 参数，或在 docker-compose.yml 文件中使用 environment 字段。
Dockerfile 示例:
FROM node:lts
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
ENV NODE_ENV=production
ENV PORT=80
CMD ["node", "index.js"]
docker-compose.yml 示例:
version: '3.8'
services:
app:
build: .
ports:
- "80:80"
environment:
NODE_ENV: production
DB_HOST: db.example.com
# 敏感信息通常不直接写在这里，而是通过secrets或外部文件
# DB_PASSWORD: ${PROD_DB_PASSWORD} # 从外部变量加载
云部署平台
大多数云服务都提供图形界面或命令行工具来设置应用程序的环境变量。这是生产环境中最常见且推荐的方式，因为它与平台的部署流程紧密集成，并且通常提供了更好的安全管理敏感信息的方式。具体设置方法请参考对应平台的文档。
如何在Node.js代码中更好地使用环境变量？
仅仅访问 process.env 是不够的，还需要考虑一些细节：
处理字符串类型
记住 process.env 中的所有值都是字符串。如果你需要数字或布尔值，必须手动进行类型转换。
示例：
const port = parseInt(process.env.PORT || '3000', 10); // 转换为数字，提供默认值
const enableFeature = process.env.ENABLE_FEATURE === 'true'; // 转换为布尔值
const retryCount = Number(process.env.RETRY_COUNT); // 另一种转换为数字的方式
if (isNaN(retryCount)) {
console.warn('RETRY_COUNT 不是有效的数字');
}
提供默认值
不是所有环境变量都必须设置。对于可选配置，或者在某个环境下有通用默认值的情况，使用 || 操作符提供默认值是常见做法。
示例：
const logLevel = process.env.LOG_LEVEL || 'info';
const serverTimeout = process.env.SERVER_TIMEOUT ? parseInt(process.env.SERVER_TIMEOUT, 10) : 5000; // 另一种提供默认值的方式
验证必要变量
对于应用程序启动必需的环境变量（例如，数据库连接字符串、API密钥），最好在应用启动初期进行检查，如果缺失则抛出错误并退出。
示例：
if (!process.env.DATABASE_URL) {
console.error('FATAL ERROR: DATABASE_URL environment variable is not set.');
process.exit(1); // 退出进程
}
const dbUrl = process.env.DATABASE_URL;
// ... 使用 dbUrl ...
更复杂的配置加载和验证可以使用专门的配置管理库。
管理环境（NODE_ENV）
通常会设置一个名为 NODE_ENV 的环境变量来标识当前运行环境（如 development, test, production）。Node.js社区和许多库会根据这个变量来调整行为（例如，生产环境通常会优化性能，关闭调试信息）。
示例：
const isProduction = process.env.NODE_ENV === 'production';
if (isProduction) {
// 生产环境特有的配置或逻辑
} else {
// 开发或测试环境特有的配置或逻辑
}
最佳实践总结
- 不要将秘密（Secrets）硬编码到代码中。 始终使用环境变量或其他秘密管理机制。
- 不要将包含敏感信息的.env文件提交到版本控制系统。 将 .env 添加到 .gitignore。
- 为本地开发创建一个.env.example文件模板。 这个文件可以提交到版本控制，它包含所有需要的环境变量名称以及非敏感的示例值或说明，帮助团队成员了解需要配置哪些变量。
-
在应用启动时尽早加载环境变量。 如果使用dotenv，确保
require('dotenv').config()是应用入口文件的第一行或前几行代码。 - 验证必需的环境变量。 在应用启动时检查关键变量是否存在，如果缺失则明确报错并退出。
- 处理环境变量的类型转换。 process.env 中的值都是字符串，需要手动转换为数字、布尔值等。
- 利用部署平台的特性管理生产环境变量。 它们通常提供更安全和便捷的方式。
-
使用清晰、具有描述性的变量名称。 例如，使用
DATABASE_URL或DB_HOST而不是VAR1。
