Node.js 安装教程与环境变量配置

6. 验证是否安装成功

点击 Finish 完成安装

• 按 Win + R，输入 cmd 回车
• 输入：node -v 回车，再输入：npm -v 回车

能看到版本号，说明安装成功。

3. 环境配置（照做即可）

3.1 新建两个文件夹

进入这两个文件夹，复制它们的'文件夹地址'（后面要用）

打开你的 Node.js 安装目录，新建两个文件夹：node_cache、node_global

3.2 设置 npm 的全局目录和缓存

1. 按 Win + X -> 选择 终端（管理员），分别执行下面两条命令（把路径换成你自己的）

npm config set prefix "D:\Developer\runtimes\NodeJS\node_global"
npm config set cache "D:\Developer\runtimes\NodeJS\node_cache"

注意：一定要用'管理员'打开终端，否则可能失败。

补充：prefix 设置 npm 全局安装包的存放目录，当使用 npm install -g package-name 安装全局包的时候，会默认安装到此目录，从而统一管理 Node.js 相关文件。cache 设置 npm 下载缓存的存放目录，将下载的包先缓存到这里，下次安装同版本时直接使用缓存，从而节省空间，加快安装速度。

2. 检查是否设置成功（复制粘贴执行）：

npm config get prefix
npm config get cache

显示的是你自己的文件夹地址，就说明对了。

3.3 配环境变量

1. 点击'新建'，创建系统变量 NODE_PATH

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

变量值：node_global 文件夹的路径 + \node_modules

2. 在'用户变量'里编辑 Path

把默认的 ...AppData\Roaming\npm 改成你的 node_global 路径

3. 在'系统变量'里选择 Path -> '编辑' -> '新建' -> 输入：%NODE_PATH%

一路点'确定'保存，关闭所有窗口后，重新打开 终端/命令行（这一步很关键）

4. 测试（配置有没有生效）

1. 按 Win + X -> 选择 终端（管理员）
2. 执行下面命令（安装一个全局包做验证）

npm install express -g // -g 代表全局安装

看到安装成功的输出，就说明配置成功。

5. (推荐) 设置 npm 国内镜像（下载更快）

如果你发现 npm install 很慢，再做这一步：

1. 按 Win + X -> 选择 终端（管理员），执行：

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

2. 验证：

npm config get registry

显示 https://registry.npmmirror.com 就成功。

到这里，你的 Node.js 安装与环境变量配置就完成了。

6. 常见问题

6.1 权限不足 (EPERM)

在使用的时候报错较多，显示 EPERM 错误，这个错误通常是因为文件/文件夹权限问题导致的，错误示例如下：

解决方案：

键盘【Win+X】，打开终端管理员，重新尝试。如果不行，需要修改 Node.js 安装目录权限，修改 npm 缓存目录权限，仍旧在终端管理员执行下述命令。

# 修改 Node.js 安装目录权限
icacls "你的 Node.js 安装目录" /grant Users:F /T
# 修改 npm 缓存目录权限
icacls "你的 node_global 目录" /grant Users:F /T
icacls "你的 node_cache 目录" /grant Users:F /T

可以通过以下指令，获取你对应的目录

npm config get prefix
npm config get cache

示例如下

icacls "D:\Developer\runtimes\NodeJS" /grant Users:F /T
icacls "D:\Developer\runtimes\NodeJS\node_global" /grant Users:F /T
icacls "D:\Developer\runtimes\NodeJS\node_cache" /grant Users:F /T