Windows系统安装Node.js及配置环境变量详细步骤

一、安装前准备与版本选择（LTS 与 Current）

在开始下载安装前，首先需要前往Node.js官方网站确认所需要的安装版本。官方通常提供两个主要下载分支：LTS（长期支持版）和Current（最新特性版）。理解这两种版本的差异有助于避免后续开发中的兼容性障碍。

选择结论：对于 Windows 平台下的日常开发与学习，强烈建议下载 LTS 版本的 64-bit Windows Installer (.msi) 安装包。MSI 安装包封装了完整的向导程序，能自动写入基础注册表项与基础路径。

二、Node.js 安装向导操作步骤详解

下载好 .msi 安装包后，双击即可启动安装向导。以下是安装过程中的几个关键界面与选择建议：

1. 欢迎与许可协议：双击运行安装包后，在弹出的欢迎界面点击“Next”，勾选“I accept the terms in the License Agreement”（我接受许可协议），继续点击“Next”。
2. 自定义安装路径（Destination Folder）：默认安装路径为 C:\Program Files\nodejs\。为了防止 C 盘占用过多以及规避 Windows 对 Program Files 目录的严格写入控制，建议根据个人硬盘划分更改至其他磁盘，例如：
   D:\nodejs\ 或 D:\Program Files\nodejs\。
   注意：路径中严禁包含中文字符或特殊符号，尽量使用纯英文字符与标准下划线。
3. 定制安装选项（Custom Setup）：向导默认会勾选所有组件，包括 Node.js runtime、npm package manager、Online documentation shortcuts 以及 Add to PATH。务必保持默认全部开启，尤其是“Add to PATH”，它会自动将 Node 主程序的安装路径添加到 Windows 系统环境变量中。
4. 原生模块工具选项（Tools for Native Modules）：安装向导有一步会提示“Automatically install the necessary tools...（自动安装必要工具，包括 Chocolatey、Python 和 Visual Studio Build Tools）”。
   建议：对于大多数常规前端与日常 Node.js 开发者，此项请勿勾选！如果勾选，安装完成后会自动启动 PowerShell 脚本下载数 GB 的 C++ 编译套件与 Chocolatey，耗时极长且占用大量磁盘空间。如果未来项目确实涉及需要本地编译的原生 C++ 扩展，再单独按需安装即可。
5. 完成安装：确认无误后点击“Install”，在 Windows 用户账户控制（UAC）弹窗中选择“是”，等待进度条跑完后点击“Finish”关闭向导。

三、为什么必须自定义配置 npm 全局目录与环境变量？

许多初学者在完成向导后直接运行 npm install -g yarn 或 npm install -g @vue/cli，很快就会发现终端提示“'yarn' 不是内部或外部命令，也不是可运行的程序”，或者发现 C 盘空间被迅速消耗。

要理解这个问题，必须了解 npm 在 Windows 下的默认存储机制与自定义路径机制的关键差异：

• 默认模式（C 盘 Roaming 目录）：在未做任何配置时，npm 全局安装的模块与缓存全部存放在当前用户的个人数据目录下：
  C:\Users\<用户名>\AppData\Roaming\npm 和 C:\Users\<用户名>\AppData\Local\npm-cache。
  缺陷：AppData 属于隐藏文件夹；一旦重装系统或多个用户切换，包数据不易迁移；而且 Windows 默认对 AppData 部分子目录有权限保护，容易出现 EACCES 写入拒绝。
• 自定义模式（专用目录集中管理）：将全局安装包与缓存统一指定在 Node.js 的安装目录下（例如 D:\nodejs\node_global 和 D:\nodejs\node_cache）。
  优势：数据与 Node.js 程序主体同盘管理，条理清晰；释放系统盘存储压力；只需在系统环境变量 Path 中配置一次，即可长期保持所有全局命令行工具的可用性。

四、环境变量配置详细步骤（核心实操）

接下来进行最为核心的环境变量配置操作。请严格按照以下步骤顺序进行：

步骤 1：在安装目录下新建两个文件夹

打开 Windows 文件资源管理器，进入刚才安装 Node.js 的主目录（本文以 D:\nodejs 为例），在根目录下新建两个空文件夹，分别命名为：

• node_global —— 用于存放未来使用 npm install -g 下载的所有全局工具与模块。
• node_cache —— 用于存放 npm 的下载缓存与校验元数据。

步骤 2：通过命令行配置 npm 指针

按 Win + R 键打开“运行”窗口，输入 cmd 并回车打开命令提示符。分别执行以下两条命令，将 npm 的全局安装路径与缓存路径指向刚才新建的文件夹（如果你的安装盘符或路径不同，请替换为实际路径）：

npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

执行完成后，可以输入以下命令检查配置是否生效：

npm config get prefix
npm config get cache

步骤 3：配置系统环境变量 NODE_PATH

此变量的作用是让 Node.js 代码中的 require() 语句能够正确定位并加载在全局目录中安装的公用模块：

1. 在桌面上右键点击“此电脑”（或“我的电脑”），选择“属性”。
2. 在弹出的系统设置页面中，点击“高级系统设置”（Windows 11 通常在页面底部或右侧相关链接中）。
3. 在“系统属性”弹窗中，切换到“高级”选项卡，点击底部的“环境变量(N)...”按钮。
4. 在下方的“系统变量”区域中，点击“新建(W)...”：
   • 变量名：输入 NODE_PATH
   • 变量值：输入 D:\nodejs\node_global\node_modules
   注意：路径末尾必须包含 \node_modules。该子目录在后续首次全局安装模块时会自动生成，但提前配准变量不会有任何影响。
5. 点击“确定”保存该变量。

步骤 4：配置系统与用户 Path 变量

Path 变量决定了我们在 CMD 或 PowerShell 中输入一个命令名称时，Windows 系统去哪些目录中寻找可执行文件（.exe、.cmd、.bat）。

1. 检查系统变量中的 Path：
   在“系统变量”列表中找到名为 Path 的项，选中后点击“编辑(I)...”。确认其中是否存在 Node.js 的安装目录 D:\nodejs\（通常安装向导已自动添加；若没有，点击“新建”手动添加该项）。
2. 修改用户变量中的 Path（关键步骤）：
   在上方的“用户变量”区域中，同样找到 Path 项，选中并点击“编辑(E)...”。
   此时会发现一条默认指向原 C 盘缓存的记录：
   C:\Users\<用户名>\AppData\Roaming\npm
   请双击该条目，将其修改为你自定义的全局路径：
   D:\nodejs\node_global
   如果不修改或保留原 C 盘条目，系统将无法正确找到在 node_global 下生成的全局命令脚本。
3. 依次点击各窗口的“确定”按钮关闭所有弹窗，使环境变量修改正式保存入系统注册表。

五、安装与配置结果全流程验证

在新的命令提示符窗口中，依次执行以下验证步骤：

1. 验证 Node.js 与 npm 核心版本

node -v
npm -v

如果能正确输出形如 v20.x.x 和 10.x.x 的版本号，说明 Node.js 与 npm 基础运行环境已成功就绪。

2. 验证全局模块安装与命令调用

为了检验自定义的 node_global 目录与 Path 变量是否真正生效，我们以全局安装轻量工具 yarn 为例进行实测：

npm install -g yarn

安装完成后，检查物理路径：打开 D:\nodejs\node_global 文件夹，可以看到已经生成了 yarn 与 yarn.cmd 批处理脚本，并且其子目录 node_modules 中出现了 yarn 包文件夹。

接着直接在命令行中输入全局命令：

yarn -v

如果成功输出版本号，说明 Windows 已经能够顺着修改后的 Path 正确检索到 D:\nodejs\node_global 下的可执行文件，全局安装与环境变量配置全部大功告成。

六、Windows 环境常见问题与排查方法

在实际配置过程中，由于 Windows 系统的安全策略与权限机制，部分用户可能会遇到以下几类典型问题：

问题 1：PowerShell 报错“无法加载文件...因为在此系统上禁止运行脚本”

现象描述：在 CMD 中输入 yarn -v 或 pnpm -v 运行正常，但在 Windows PowerShell 或 VS Code 默认终端中运行时出现红字报错：
yarn : 无法加载文件 D:\nodejs\node_global\yarn.ps1，因为在此系统上禁止运行脚本。(PSSecurityException)

原因解释：Windows 默认的 PowerShell 执行策略为 Restricted，禁止执行未经数字签名的外部 .ps1 脚本，而 npm 在全局安装时会同时生成用于 CMD 的 .cmd 和用于 PowerShell 的 .ps1 脚本。

解决方法：以管理员身份打开 PowerShell，执行以下命令，将当前用户的执行策略调整为 RemoteSigned（允许本地脚本无限制执行，仅对从网络直接下载的脚本要求签名验证）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

在弹出的确认选项中输入 Y 回车即可。修改完成后无需管理员权限，普通终端即可正常调用全局脚本。

问题 2：执行 npm install -g 提示权限拒绝（EACCES / operation not permitted）

原因解释：如果将 Node.js 安装在 C 盘系统目录，或者自建的 node_global 文件夹被赋予了只读属性，普通用户权限下的 npm 会因为无法向该目录写入文件而中断。

解决方法：

1. 在资源管理器中找到 D:\nodejs 文件夹，右键选择“属性”。
2. 切换到“安全”选项卡，点击“编辑”按钮。
3. 选中当前 Windows 登录用户名（例如 Users 或你的具体账户名），在下方的权限列表中勾选“完全控制”或“修改”与“写入”权限，点击确定应用到子文件及文件夹。

问题 3：命令依然提示“不是内部或外部命令”

排查清单：

• 终端未刷新：检查是否忘记重启命令行窗口。
• 路径错位：检查用户变量 Path 中的路径是否写成了 D:\nodejs\node_global\node_modules。正确的 Path 必须指向包含 .cmd 文件的 D:\nodejs\node_global 这一级，只有 NODE_PATH 才需要指向子目录 node_modules。
• 旧路径干扰：检查用户变量与系统变量中是否还残留着 C:\Users\<用户名>\AppData\Roaming\npm，若有必须彻底删除或移至下方。

七、配置要点总结速查