Node.js 在 Windows 上的安装与环境变量配置指南
在 Windows 环境下搭建 Node.js 开发环境，核心步骤其实很明确：下载安装、配置路径、设置环境变量、验证运行。下面按实际工作流梳理一遍，重点解释几个容易踩坑的配置项。
一、下载安装包
直接访问 Node.js 官网下载页，选择对应的 LTS 版本或当前版本。
如果需要旧版本，可以在页面找到'之前的版本'入口。根据系统架构选择 Windows 安装包（.msi） 进行下载。
二、安装程序
双击下载的 .msi 文件开始安装。
- 安装路径：建议避开 C 盘，选 D 盘或 E 盘即可。注意目录中不要包含中文、空格或特殊字符，这能避免后续很多兼容性问题。
- 默认选项：后续步骤保持默认勾选即可，除非你有特殊的定制需求。
- 完成安装：点击 Install 等待进度条走完，最后点 Finish。
安装完成后，先别急着下一步，打开命令行验证一下基础环境是否就绪。按 Win + R，输入 cmd 回车，依次执行：
node -v
npm -v
如果能打印出版本号，说明基础安装没问题。
三、环境配置
这一步是为了让 npm 的全局包和缓存有独立的存放位置，方便管理和释放空间。
1. 新建文件夹
在你的非系统盘（比如 D 盘）下新建两个文件夹，分别命名为 node_global 和 node_cache。记下这两个文件夹的绝对路径，后面要用到。
2. 设置 npm 配置
右键'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'，或者直接搜索'环境变量'。这里我们需要用管理员权限操作终端来修改配置。
按 Win + X 选择 终端（管理员），执行以下命令（请将路径替换为你实际创建的路径）：
npm config set prefix "D:\Deleloper\runtimes\NodeJS\node_global"
npm config set cache "D:\Deleloper\runtimes\NodeJS\node_cache"
注意：一定要用管理员权限打开终端，否则可能因权限不足导致配置失败。
这里的 prefix 用于指定全局安装包的存放目录，cache 则是 npm 下载包的缓存目录。分开管理可以避免全局包污染系统目录，也能加快重复安装的加载速度。
执行完上述命令后，可以验证一下是否生效：
npm config get prefix
npm config get cache
如果输出的路径和你刚才设置的一致，说明配置成功。
3. 配置环境变量
为了让系统能找到全局安装的命令，还需要配置系统环境变量。
-
新建 NODE_PATH：在'系统变量'区域点击'新建'，变量名填
NODE_PATH，变量值填node_global文件夹的路径加上\node_modules。 例如：D:\Deleloper\runtimes\NodeJS\node_global\node_modules
-
编辑 Path 变量：在'用户变量'中找到
Path，选中默认的...AppData\Roaming\npm这一项，将其修改为你的node_global路径。 或者在'系统变量'里选择Path-> '编辑' -> '新建' -> 输入%NODE_PATH%。
-
重启终端：修改环境变量后，必须关闭所有已打开的终端窗口并重新打开，新配置才会生效。
四、测试验证
配置完成后，再次打开终端（管理员），尝试安装一个轻量级的全局包来验证环境是否通畅。
npm install express -g
看到安装成功的输出日志，就说明环境变量配置正确了。
五、切换 npm 镜像源
在国内网络环境下，直接使用官方源下载依赖往往很慢。推荐切换到国内镜像源，如淘宝镜像。
在终端（管理员）中执行：
npm config set registry https://registry.npmmirror.com
验证是否切换成功：
npm config get registry
显示 https://registry.npmmirror.com 即表示切换完毕。
六、常见问题排查
权限不足 (EPERM)
如果在安装过程中遇到 EPERM 错误，通常是因为文件权限不足导致的。
解决方案：
- 确保使用管理员权限打开终端重试。
- 如果不行，需要手动修改 Node.js 安装目录及相关缓存目录的权限。
在管理员终端中执行以下命令（请替换为实际路径）：
icacls "D:\Deleloper\runtimes\NodeJS" /grant Users:F /T
icacls "D:\Deleloper\runtimes\NodeJS\node_global" /grant Users:F /T
icacls "D:\Deleloper\runtimes\NodeJS\node_cache" /grant Users:F /T
可以通过 npm config get prefix 和 npm config get cache 获取正确的目录路径。
至此，Node.js 的基础环境与开发工具链配置基本完成，可以开始后续的开发工作了。
