手把手教你配置Node.js环境变量，提升开发效率

目录

一、系统级环境变量：让 Node.js 在全局可用

前提：安装 Node.js

场景 1：Windows 系统配置（最常用）

步骤 1：找到 Node.js 安装路径

步骤 2：打开环境变量配置界面

步骤 3：配置 PATH 变量

步骤 4：验证配置是否成功

场景 2：macOS/Linux 系统配置

步骤 1：找到 Node 安装路径

步骤 2：编辑环境变量配置文件

步骤 3：添加 Node 路径到 PATH

步骤 4：生效配置并验证

二、项目级环境变量：管理项目配置（提升开发效率核心）

工具：使用dotenv管理项目环境变量

步骤 1：安装dotenv

步骤 2：创建.env文件

步骤 3：在代码中加载.env

步骤 4：区分不同环境（开发 / 生产）

步骤 5：忽略.env文件（关键！）

三、常见问题与解决方法

总结

---

配置 Node.js 环境变量是前端 / 后端开发的基础操作，不仅能让你在任意目录下直接使用node和npm命令，还能通过环境变量管理项目配置（如 API 密钥、数据库地址等），避免硬编码敏感信息。下面分系统级环境变量（让 Node 全局可用） 和项目级环境变量（管理项目配置） 两部分，手把手教你配置。

一、系统级环境变量：让 Node.js 在全局可用

系统级环境变量的核心作用是：让操作系统在任意目录下都能识别node、npm等命令，无需每次切换到 Node 安装目录。

前提：安装 Node.js

首先确保已安装 Node.js（环境变量配置依赖安装路径）：

1. 官网下载对应系统版本：Node.js 官网（推荐 LTS 长期支持版）
2. 安装时注意：Windows 建议勾选 “Add to PATH”（自动配置环境变量），macOS/Linux 默认会配置，但可能需要手动调整。

场景 1：Windows 系统配置（最常用）

如果安装时没勾选 “Add to PATH”，或后期移动了 Node 安装目录，需手动配置：

步骤 1：找到 Node.js 安装路径

默认安装路径通常是：

• 32 位系统：C:\Program Files (x86)\nodejs\
• 64 位系统：C:\Program Files\nodejs\（可通过 “此电脑→右键→属性→高级系统设置→环境变量” 先检查是否已有该路径，没有则继续）

步骤 2：打开环境变量配置界面

1. 按下Win + R，输入sysdm.cpl，回车打开 “系统属性”
2. 点击 “高级”→“环境变量”，进入配置界面（分 “用户变量” 和 “系统变量”，建议配置 “系统变量”，所有用户可用）

步骤 3：配置 PATH 变量

1. 在 “系统变量” 中找到Path变量，双击打开
2. 点击 “新建”，粘贴 Node.js 的安装路径（如C:\Program Files\nodejs\）
3. 点击 “确定” 保存（所有弹窗都要点击确定，否则配置不生效）

步骤 4：验证配置是否成功

1. 打开新的命令提示符（Win + R输入cmd）或 PowerShell
2. 输入以下命令，若能显示版本号，说明配置成功：

node -v  # 显示Node版本，如v18.18.0
npm -v   # 显示npm版本，如9.8.1

场景 2：macOS/Linux 系统配置

macOS 和 Linux 基于 Unix 系统，环境变量配置方式类似，默认安装后node和npm已在PATH中，若不可用需手动添加：