Node.js如何处理环境变量？

在Node.js项目开发过程中，环境变量是区分开发、测试、生产等不同运行环境配置的核心手段，能够避免将敏感配置硬编码到代码中，提升项目的安全性和可维护性。Node.js提供了原生的环境变量处理能力，同时也有成熟的第三方库可以简化环境变量的管理流程。

原生环境变量读取：process.env对象

Node.js内置的process对象提供了一个env属性，该属性是一个包含所有环境变量的对象，开发者可以直接通过这个对象读取当前进程的环境变量。在Node.js中，所有的环境变量最终都会被转换为字符串类型存储。

读取环境变量示例

假设我们在启动Node.js进程时设置了PORT和DB_HOST两个环境变量，可以通过以下代码读取：

// 读取PORT环境变量，如果没有设置则默认使用3000
const port = process.env.PORT || 3000;
// 读取DB_HOST环境变量
const dbHost = process.env.DB_HOST;

console.log(`服务启动端口：${port}`);
console.log(`数据库地址：${dbHost}`);

原生设置环境变量

Node.js不支持直接通过代码修改当前进程的环境变量，环境变量需要在启动进程前设置，不同操作系统的设置方式略有不同：

• Windows命令行：使用set 变量名=变量值的方式设置，比如set PORT=3001 && node app.js
• macOS/Linux终端：使用export 变量名=变量值的方式设置，比如export PORT=3001 && node app.js
• 也可以在启动命令中直接拼接变量：PORT=3001 node app.js

使用dotenv库管理环境变量

原生读取环境变量的方式需要提前在系统中设置变量，不利于项目的协作和配置管理，因此实际开发中通常会使用dotenv第三方库，该库可以从项目根目录的.env文件中加载环境变量到process.env中。

安装dotenv

首先通过npm安装dotenv依赖：

npm install dotenv

配置和使用dotenv

首先在项目的根目录下创建.env文件，文件中按照键=值的格式写入环境变量，注意不需要加引号，每行一个变量：

PORT=3000
DB_HOST=127.0.0.1
DB_USER=root
DB_PASSWORD=123456

然后在项目的入口文件最顶部引入并配置dotenv：

// 必须在其他引入和逻辑之前调用config方法
require('dotenv').config();

// 之后就可以正常读取.env中的变量
const port = process.env.PORT;
const dbHost = process.env.DB_HOST;

console.log(port); // 输出3000
console.log(dbHost); // 输出127.0.0.1

dotenv的注意事项

• .env文件通常包含敏感信息，一定要将其添加到.gitignore中，避免提交到代码仓库
• 可以创建.env.example文件作为示例，列出需要的环境变量名称但不填写具体值，方便其他开发者参考配置
• dotenv加载的变量会覆盖已经存在的同名环境变量，如果需要避免覆盖，可以在config中设置override: false

环境变量的常见使用场景

环境变量在实际开发中有非常多的应用场景，常见的包括：

• 区分运行环境：通过NODE_ENV变量判断当前是开发还是生产环境，从而加载不同的配置，比如生产环境关闭调试日志
• 存储敏感配置：数据库密码、API密钥、第三方服务token等敏感信息通过环境变量传递，避免硬编码
• 动态配置服务参数：比如服务的启动端口、静态资源路径等可以通过环境变量灵活调整

注意事项

• 环境变量的类型都是字符串，如果需要其他类型（比如数字、布尔值），需要手动做类型转换，比如const port = Number(process.env.PORT)
• 不要在环境变量中存储过长的配置内容，过长的环境变量可能会在某些系统中出现兼容性问题
• 生产环境的环境变量建议通过部署平台（比如Docker、云服务器）的配置功能设置，而不是依赖.env文件

Node.js环境变量process_envdotenv修改时间：2026-06-05 02:25:13