Node.js 安装与环境变量配置指南（Windows）

复制这两个文件夹的完整路径备用。

设置 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

输出结果应为你刚才设置的路径。

配置环境变量

1. 右键'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。

2. 在'系统变量'中新建 NODE_PATH，值为 node_global 文件夹路径加上 \node_modules。

3. 在'用户变量'中找到 Path，编辑并删除默认的 ...AppData\Roaming\npm，替换为你的 node_global 路径。

4. 在'系统变量'的 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 错误，通常是因为文件权限问题。解决方法如下：

1. 确保使用管理员权限打开终端重试。
2. 若仍报错，需手动修改 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 环境搭建完成。