Node.js 在 Windows 下的安装与环境变量配置指南

Node.js 在 Windows 下的安装与环境变量配置指南

在 Windows 系统上搭建 Node.js 开发环境，核心步骤其实很明确：下载安装包、配置环境变量、验证环境以及设置国内镜像源。下面按实际操作流程梳理一遍，重点说明容易出错的细节。

1. 下载安装包

访问 Node.js 官网下载页，选择适合你系统的版本。

![相关界面截图]

建议优先选择 LTS（长期支持）版本。点击 Windows 安装包（.msi） 进行下载。如果需要旧版本，可以在页面中找到'之前的版本'入口。

2. 安装程序

双击下载的 .msi 文件开始安装，大部分选项保持默认即可，但有两点需要注意：

1. 安装路径：建议不要安装在 C 盘，选 D 盘或 E 盘更稳妥。路径中不要包含中文、空格及特殊字符，避免后续出现兼容性问题。
2. 组件勾选：通常默认勾选即可，确保 Add to PATH 选项被选中（新版安装器通常会自动处理）。

![相关界面截图]

安装完成后点击 Finish。此时可以打开命令行窗口，输入以下命令检查是否安装成功：

node -v
npm -v

如果能看到版本号输出，说明基础环境已就绪。

3. 环境配置

虽然安装时可能自动配置了部分环境变量，但为了管理全局包和缓存，建议手动指定目录。

3.1 新建文件夹

在安装目录下新建两个文件夹，例如 node_global 和 node_cache。这两个文件夹将分别用于存放全局安装的模块和 npm 的缓存数据。

![相关界面截图]

复制这两个文件夹的路径，后面配置时会用到。

3.2 设置 npm 的全局目录和缓存

以管理员身份打开终端（PowerShell 或 CMD），执行以下命令替换为你实际的路径：

npm config set prefix "D:\Deleloper\runtimes\NodeJS\node_global"
npm config set cache "D:\Deleloper\runtimes\NodeJS\node_cache"

注意：一定要用管理员权限运行终端，否则可能因权限不足导致配置失败。

执行完成后，可以通过以下命令验证配置是否生效：

npm config get prefix
npm config get cache

如果输出的路径与你设置的文件夹一致，说明配置正确。

3.3 配置系统环境变量

这一步是为了让系统能找到全局安装的命令。

1. 创建 NODE_PATH：右键'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。在'系统变量'区域新建一个变量，名称为 NODE_PATH，值为 node_global 文件夹的路径 + \node_modules。

   ![相关界面截图]

2. 修改 Path 变量：在'用户变量'中找到 Path，编辑后删除默认的 ...AppData\Roaming\npm，添加你的 node_global 路径（或者确保该路径下包含可执行文件）。

   ![相关界面截图]

3. ：在'系统变量'的 中新建一项，输入 。