node怎么配置环境变量

更新日期：2026-11-12 04:24:13

标题

node怎么配置环境变量

内容

在使用 Node.js 开发过程中，配置环境变量是一个非常常见的需求。无论是开发、测试还是生产环境，合理的环境变量配置能够提高应用的灵活性和安全性。下面将从不同平台（Windows、MacOS、Linux）出发，总结 Node.js 配置环境变量的方法，并以表格形式进行对比说明。

一、什么是环境变量？

环境变量是操作系统或运行时环境中用于存储配置信息的一种方式。Node.js 应用可以通过读取这些变量来获取数据库连接地址、API 密钥、调试模式等关键信息。

二、常见配置方式

1. 使用 `.env` 文件（推荐）

这是目前最流行的方式之一，通过 `dotenv` 模块加载 `.env` 文件中的变量。适用于大多数项目结构。

- 优点：简单、易维护、支持多环境（如 .env.development、.env.production）

- 缺点：需额外安装依赖

2. 命令行直接设置

在启动 Node.js 应用时，通过命令行传递环境变量。

- 优点：快速、灵活

- 缺点：每次启动都需要重新输入

3. 系统级环境变量

在操作系统中设置全局变量，适用于所有应用。

- 优点：跨项目共享

- 缺点：可能带来安全风险

三、各平台配置方法对比表

平台	配置方式	具体步骤	是否需要代码修改	适用场景
Windows	`.env` 文件	创建 `.env` 文件，写入 `KEY=VALUE`，使用 `dotenv` 加载	是	开发、测试环境
Windows	命令行设置	在 CMD 或 PowerShell 中执行 `set KEY=VALUE`，再运行 node 应用	否	快速测试、临时使用
Windows	系统变量设置	控制面板 -> 系统 -> 高级系统设置 -> 环境变量，添加变量	否	生产环境、长期使用
macOS/Linux	`.env` 文件	创建 `.env` 文件，使用 `dotenv` 模块加载	是	开发、测试环境
macOS/Linux	命令行设置	在终端中执行 `export KEY=VALUE`，再运行 node 应用	否	快速测试、临时使用
macOS/Linux	系统变量设置	编辑 `/etc/profile` 或用户目录下的 `.bashrc`、`.zshrc` 等文件	否	生产环境、长期使用

四、代码示例（使用 dotenv）

```javascript

// app.js

require('dotenv').config();

console.log(process.env.MY_ENV_VAR);

```

创建 `.env` 文件：

```

MY_ENV_VAR=hello-world

```

五、注意事项

- 不要将敏感信息（如数据库密码、密钥）提交到版本控制中。

- 生产环境建议使用系统级变量或配置管理工具（如 Docker、Kubernetes）。

- 多环境配置建议使用 `.env.development`、`.env.production` 等命名规范。

总结

配置 Node.js 的环境变量可以根据项目需求和开发习惯选择合适的方式。对于大多数开发者来说，使用 `.env` 文件配合 `dotenv` 是一个高效且安全的选择。而系统级变量则更适合生产环境或需要统一配置的场景。合理配置环境变量，可以提升项目的可维护性和安全性。

随便看