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

安装完成后，先别急着下一步，打开命令行验证一下基础环境是否就绪。按 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. 配置环境变量

为了让系统能找到全局安装的命令，还需要配置系统环境变量。

1. 新建 NODE_PATH：在'系统变量'区域点击'新建'，变量名填 NODE_PATH，变量值填 node_global 文件夹的路径加上 \node_modules。 例如：D:\Deleloper\runtimes\NodeJS\node_global\node_modules

   

2. 编辑 Path 变量：在'用户变量'中找到 Path，选中默认的 ...AppData\Roaming\npm 这一项，将其修改为你的 node_global 路径。 或者在'系统变量'里选择 Path -> '编辑' -> '新建' -> 输入 %NODE_PATH%。

   

3. 重启终端：修改环境变量后，必须关闭所有已打开的终端窗口并重新打开，新配置才会生效。

四、测试验证

配置完成后，再次打开终端（管理员），尝试安装一个轻量级的全局包来验证环境是否通畅。

npm install express -g

看到安装成功的输出日志，就说明环境变量配置正确了。

五、切换 npm 镜像源

在国内网络环境下，直接使用官方源下载依赖往往很慢。推荐切换到国内镜像源，如淘宝镜像。

在终端（管理员）中执行：

npm config set registry https://registry.npmmirror.com

验证是否切换成功：

npm config get registry

显示 https://registry.npmmirror.com 即表示切换完毕。

六、常见问题排查

权限不足 (EPERM)

如果在安装过程中遇到 EPERM 错误，通常是因为文件权限不足导致的。

解决方案：

1. 确保使用管理员权限打开终端重试。
2. 如果不行，需要手动修改 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 的基础环境与开发工具链配置基本完成，可以开始后续的开发工作了。