Node.js 安装与环境变量配置指南（Windows）
在 Windows 系统下搭建 Node.js 开发环境，核心步骤包括下载安装包、配置全局目录与缓存、设置环境变量以及切换国内镜像源。以下流程基于实际开发经验整理，旨在确保环境稳定且便于管理。
获取安装包
- 访问官网下载页：https://nodejs.org/zh-cn/download
- 如需旧版本，可在页面查找历史版本入口。
- 选择对应系统版本，点击 Windows 安装包（.msi） 进行下载。
执行安装
- 双击下载的
.msi文件，一路点击 Next。 - 选择安装位置时，建议避开 C 盘（如 D 盘或 E 盘），且路径中不要包含中文、空格或特殊字符。
- 后续步骤保持默认即可，继续点击 Next。
- 点击 Install 开始安装，完成后点击 Finish。
- 验证安装：按
Win + R输入cmd，依次执行node -v和npm -v。
若能看到版本号，说明基础安装成功。
环境配置
新建文件夹
进入 Node.js 安装目录，新建两个文件夹用于存放全局包和缓存，例如 node_global 和 node_cache。
复制这两个文件夹的完整路径备用。
设置 npm 全局目录和缓存
以管理员身份打开终端（PowerShell 或 CMD），执行以下命令替换为你自己的路径：
npm config set prefix "D:\Deleloper\runtimes\NodeJS\node_global"
npm config set cache "D:\Deleloper\runtimes\NodeJS\node_cache"
注意：务必使用管理员权限运行终端，否则可能因权限不足导致配置失败。
这里 prefix 用于指定全局安装包的存放位置，cache 则用于缓存下载的文件，两者配合可避免文件分散且提升安装速度。
检查配置是否生效：
npm config get prefix
npm config get cache
输出结果应为你刚才设置的路径。
配置环境变量
- 右键'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。
- 在'系统变量'中新建
NODE_PATH，值为node_global文件夹路径加上\node_modules。
- 在'用户变量'中找到
Path，编辑并删除默认的...AppData\Roaming\npm，替换为你的node_global路径。
- 在'系统变量'的
Path中，新建一项%NODE_PATH%。
保存所有设置后，重新打开终端使环境变量生效。
测试配置
打开管理员终端，尝试安装一个全局包来验证：
npm install express -g
看到安装成功的日志即表示配置无误。
设置国内镜像源
如果 npm install 速度较慢，可以切换至国内镜像：
npm config set registry https://registry.npmmirror.com
验证命令：
npm config get registry
显示 https://registry.npmmirror.com 即代表成功。
常见问题处理
权限不足 (EPERM)
安装过程中若遇到 EPERM 错误，通常是因为文件权限问题。解决方法如下：
- 确保使用管理员权限打开终端重试。
- 若仍报错，需手动修改 Node.js 安装目录及 npm 缓存目录的权限。
在管理员终端执行以下命令（替换为实际路径）：
icacls "你的 Node.js 安装目录" /grant Users:F /T
icacls "你的 node_global 目录" /grant Users:F /T
icacls "你的 node_cache 目录" /grant Users:F /T
可通过 npm config get prefix 和 npm config get cache 获取具体路径。
示例：
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
至此，Node.js 环境搭建完成。
