【保姆级】Node.js 最新安装教程，附环境变量配置

🎬 博主名称：超级苦力怕

🔥 个人专栏：《Java成长录》《AI 工具使用目录》

🚀 每一次思考都是突破的前奏，每一次复盘都是精进的开始！

安装目录

• 零基础安装 Node.js（Windows）
  • 1. 下载安装包
  • 2. 安装程序
  • 3. 环境配置（照做即可）
    • 3.1 新建两个文件夹
    • 3.2 设置 npm 的全局目录和缓存
    • 3.3 配环境变量
  • 4. 测试（配置有没有生效）
  • 5. (推荐)设置 npm 国内镜像（下载更快）
  • 6. 拓充：常见问题
    • 6.1 权限不足 (EPERM)

零基础安装 Node.js（Windows）

• 你只要照做：下载 -> 安装 -> 配环境变量 -> 验证
• 看不懂没关系：每张图就是上一步文字的结果

1. 下载安装包

1. 打开官网下载页：官网下载传送门

想下载旧版本：在页面里找到“之前的版本/历史版本”入口

选择你的系统版本，点击 Windows 安装包（.msi） 下载

2. 安装程序

1. 双击下载好的 .msi，一路点 Next
2. 到选择安装位置这一步：建议不要装在 C 盘（选 D/E 盘即可）、建议目录中不要包含中文、空格以及特殊字符

3. 这一步保持默认即可

4. 继续 Next

5. 点击 Install 开始安装

6. 验证是否安装成功

点击 Finish 完成安装

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

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

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

3.1 新建两个文件夹

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

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

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

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

npm config set prefix "D:\Deleloper\runtimes\NodeJS\node_global"

npm config set cache "D:\Deleloper\runtimes\NodeJS\node_cache"

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

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

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

npm config get prefix npm config get cache 

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

3.3 配环境变量

5. 点击“新建”，创建系统变量 NODE_PATH

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

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

7. 在“用户变量”里编辑 Path

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

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

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

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

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

npminstall 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缓存目录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