Node.js 在 Windows 上的安装与配置详解
很多开发者在搭建环境时容易忽略细节，导致后续运行项目频频报错。其实只要把基础路径和缓存目录规划好，后面会顺畅很多。下面以 Windows 系统为例，梳理一套稳妥的安装流程。
1. 下载安装包
打开 Node.js 官网下载页，选择 Windows 安装包（.msi）。如果不需要最新版本，可以在页面找到历史版本入口。建议优先选择 LTS（长期支持）版本，稳定性更好。
2. 安装程序
双击下载的 .msi 文件开始安装。这一步有几个关键点：
- 安装路径：建议避开 C 盘，选 D 或 E 盘。路径中不要包含中文、空格及特殊字符，否则可能引发兼容性问题。
- 组件选项：保持默认即可，通常会自动勾选添加环境变量。
- 完成验证：点击 Finish 后，按
Win + R输入cmd打开终端，依次执行node -v和npm -v。若能显示版本号，说明基础安装成功。
3. 环境配置（核心步骤）
虽然安装程序会尝试自动配置，但为了管理方便，建议手动指定全局包和缓存的存放位置。
3.1 新建文件夹
在安装目录下新建两个文件夹，例如 node_global 和 node_cache。记住这两个文件夹的完整路径，后面要用到。
3.2 设置 npm 配置
以管理员身份打开终端（PowerShell 或 CMD），执行以下命令将路径替换为你实际的路径：
npm config set prefix "D:\Developer\runtimes\NodeJS\node_global"
npm config set cache "D:\Developer\runtimes\NodeJS\node_cache"
注意：一定要用管理员权限，否则可能因权限不足写入失败。
执行完成后，可以通过 npm config get prefix 和 npm config get cache 检查是否生效。
3.3 配置系统环境变量
这一步是为了让全局安装的命令在任何目录下都能被识别。
- 新建 NODE_PATH：右键'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。在系统变量中新建
NODE_PATH，值为node_global文件夹路径加\node_modules。 - 修改 Path：在用户变量中找到
Path，编辑并删除默认的...AppData\Roaming\npm，替换为你的node_global路径。或者在系统变量的 Path 中新建%NODE_PATH%。 - 重启终端：保存所有设置后，务必重新打开命令行窗口才能生效。
4. 测试与镜像源
配置完成后，装一个全局包来验证：
npm install express -g
看到安装成功的日志即表示配置无误。如果发现 npm install 速度很慢，可以切换国内镜像源：
npm config set registry https://registry.npmmirror.com
再次执行 npm config get registry 确认地址已变更。
5. 常见问题排查
如果在安装过程中遇到 EPERM 错误，通常是文件权限问题。解决方案是确保使用管理员身份运行终端。如果依然报错，可能需要手动修改安装目录的权限：
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 获取具体路径代入上述命令即可。
