Windows 系统 Node.js 下载安装与环境变量配置教程

封面导览：Windows 下 Node.js 安装与全局环境变量配置架构图

在 Windows 系统中安装 Node.js 本身并不复杂，但许多初学者直接一路点击“下一步”，导致后续在使用 npm install -g 全局安装模块（如 Vue CLI、TypeScript、Nodemon、pnpm 等）时，频繁遇到“命令无法识别”、“权限拒绝（EPERM）”或“系统盘空间被大量占用”等问题。本文将按规范的操作顺序，带你完成 Node.js 官方安装包的下载、自定义路径安装、npm 全局存储重定向，以及系统环境变量 Path 与 NODE_PATH 的完整配置。

一、下载准备与版本选择

访问 Node.js 官方网站（https://nodejs.org/ 或其官方中文镜像），下载页面通常会并列展示两个版本供用户选择：

• LTS（Long Term Support，长期支持版）：这是大多数项目生产环境与日常学习开发的首选版本。它的特点是稳定性极高、核心 API 经过充分验证，官方提供长达数年的维护与安全补丁，推荐绝大多数读者下载此版本。
• Current（当前尝鲜版）：包含最新的 JavaScript 语法特性与 Node.js 实验性功能。该版本变动频繁，可能存在第三方模块尚未适配的情况，除专门用于调研新特性的开发者外，不建议常规使用。

在 Windows 平台下，请直接下载 Windows Installer (.msi) 64-bit 安装程序。.msi 是 Windows 专用的安装引导包，能够自动校验系统依赖并在初次安装时注册基础运行环境。

图 1：Windows 环境下 Node.js 安装与配置全景工作流

二、运行安装向导的关键步骤

双击下载好的 .msi 文件启动安装向导，大部分界面保持默认即可，但在以下两个核心步骤需要特别留意：

1. 自定义安装目录（Destination Folder）

安装向导默认路径为 C:\Program Files\nodejs\。为了避免系统盘（C 盘）随着后续项目开发膨胀，同时也为了降低 Windows 权限安全机制对安装目录写操作的干扰，建议将安装路径修改至非系统盘或结构清晰的开发环境目录，例如：

D:\Environment\nodejs\

2. 定制组件与原生模块工具选择（Tools for Native Modules）

在“Custom Setup”组件选择界面，向导默认勾选了 Node.js 运行时、npm 包管理器以及“Add to PATH”选项，这些保持默认开启即可，向导会自动将 D:\Environment\nodejs\ 加入当前系统的临时查找路径中。

随后进入“Tools for Native Modules”界面，询问是否自动安装 Chocolatey、Python 以及 Visual Studio C++ 构建工具：

确认无误后点击“Install”，等待进度条跑完并点击“Finish”完成基础安装。

三、自定义 npm 全局模块与缓存目录

虽然此时在终端中已经可以使用 node -v 查看到版本，但如果不做目录重构，使用 npm install -g <package> 下载的全局工具默认会被存放在：

C:\Users\<用户名>\AppData\Roaming\npm\

这个目录位于系统盘深度隐藏的用户目录下，不仅占用 C 盘空间，而且如果 Windows 当前登录用户名包含中文，会导致后续执行全局命令直接报错中断。因此，我们需要将全局模块安装路径（prefix）和本地缓存路径（cache）重定向到安装目录中。

1. 手动创建对应文件夹

打开文件资源管理器，进入刚才的 Node.js 安装目录 D:\Environment\nodejs\，在其中手动新建两个空文件夹：

• node_global：用于存放未来通过 -g 全局安装的各种命令行工具及相关库。
• node_cache：用于存放 npm 在下载包过程中产生的缓存及校验文件。

2. 通过命令行绑定新路径

按下快捷键 Win + R，输入 cmd 回车打开命令提示符，依次执行以下两条命令（请将路径中的 D:\Environment\nodejs\ 替换为你实际的安装目录）：

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

3. 验证路径是否写入成功

执行完成后，可运行以下命令检查当前的配置状态：

npm config get prefix
npm config get cache

若终端回显分别为你刚刚设置的 node_global 与 node_cache 路径，说明 npm 已经将这两项参数成功持久化写入到了当前用户根目录下的 .npmrc 配置文件中。

图 2：Windows 终端执行 Node 与全局 npm 模块的寻址解耦架构

四、配置 Windows 系统环境变量

修改了 npm 的默认路径后，操作系统并不知道全局安装的可执行脚本放在了哪里，因此必须通过 Windows 的“环境变量”告诉系统去哪里查找这些工具命令，以及 Node.js 运行时该如何加载全局模块的代码。

1. 打开环境变量设置窗口

打开环境变量窗口最快的方法是：按下快捷键 Win + R，在运行窗口中输入：

sysdm.cpl

回车后会直接打开“系统属性”对话框。切换到顶部的“高级”选项卡，然后点击右下角的“环境变量(N)...”按钮。

图 3：Windows 环境变量配置界面参数映射与操作要点

2. 新增系统变量：NODE_PATH

在环境变量窗口的下半部分找到“系统变量”区域，点击下方的“新建”按钮：

• 变量名(N)：输入 NODE_PATH
• 变量值(V)：输入 D:\Environment\nodejs\node_global\node_modules

3. 修改 Path 环境变量

Path 变量决定了我们在终端输入一个命令时，Windows 会按顺序扫描哪些文件夹来寻找对应的 .exe、.cmd 或 .bat 执行文件。

1. 在“用户变量”或“系统变量”列表中找到名为 Path（或 PATH）的条目，选中后点击“编辑”。
2. 检查安装目录：确认列表中是否已有 D:\Environment\nodejs\。如果有，保留它（这是调用 node 和 npm 核心命令的依据）；如果没有，点击“新建”将其补上。
3. 替换默认全局路径：在“用户变量”的 Path 列表中，通常会存在一条安装时默认生成的 C:\Users\<用户名>\AppData\Roaming\npm。必须将其选中并点击“删除”，或者点击“编辑”直接修改为：

   D:\Environment\nodejs\node_global

修改完成后，依次点击各个窗口右下角的“确定”，直到关闭所有属性窗口。只有点击了“确定”，Windows 才会将修改写入注册表。

五、配置验证与全局模块安装实测

1. 验证基础指令

打开一个新的 CMD 窗口，输入并运行：

node -v
npm -v

正常情况下会直接打印出对应的版本号，示例输出：

v20.18.0
10.8.2

2. 实测安装全局模块

为了验证全局路径重定向与 Path 环境变量是否真正闭环生效，我们全局安装一个常用的轻量级命令行工具进行测试，例如 express-generator：

npm install -g express-generator

安装完成后，打开文件资源管理器检查 D:\Environment\nodejs\node_global\：

• 可以看到根目录下生成了 express、express.cmd 等脚本文件。
• 在 node_global\node_modules\ 目录下可以看到存放了完整的 express-generator 依赖代码包。

3. 测试全局命令调用

在 CMD 中任意切换到其他目录（例如 cd C:\），然后直接运行：

express --version

若屏幕正确回显版本号（如 4.16.1），则代表整个 Windows 环境下的 Node.js 安装、目录定制及环境变量配置已彻底成功！

图 4：环境就绪检查清单与常见异常排查决策矩阵

六、常见报错与故障排除

在实际配置过程中，若遇到异常情况，可对照下表进行针对性排查：

按照本教程的流程规范进行部署后，你的 Windows 开发环境便具备了高隔离度、不侵占系统盘空间且权限清晰的 Node.js 运行体系，为后续的前端框架搭建、全栈开发及工程化部署打下了坚实稳定的基础。