Node.js 下载安装及环境变量配置完全指南（2026 最新版）

从零开始，手把手带你完成 Node.js 的下载、安装、npm 全局路径配置、环境变量设置，并扩展镜像加速、常见问题等实战知识点。一篇搞定，少走弯路。

---

目录

• 一、为什么每个前端开发者都必须装 Node.js？
• 二、下载 Node.js
• 三、安装 Node.js
• 四、环境变量配置（核心重点）
• 五、配置 npm 国内镜像加速
• 六、常见问题与排错

---

一、为什么每个前端开发者都必须装 Node.js？

在前后端分离架构中，Node.js 早已不只是「后端运行时」这么简单。它是整个前端工程化的基石：

用途	说明
包管理	npm 是世界上最大的开源包仓库，前端项目依赖几乎都靠它
构建工具	Vite、Webpack、Rollup、esbuild 全部基于 Node.js 运行
框架脚手架	Vue CLI、Create React App、Next.js、Nuxt 等都依赖 Node.js
SSR / BFF	服务端渲染、接口聚合中间层直接跑在 Node.js 上
开发工具链	ESLint、Prettier、TypeScript 编译、Husky Git 钩子等
全栈开发	Express、Koa、NestJS、Egg.js 让 JavaScript 拥有后端能力

💡 一句话总结： 没有 Node.js，现代前端开发寸步难行。它是你本地开发环境的第一块积木。

---

二、下载 Node.js

推荐去 Node.js 官网 下载：[https://nodejs.org/en/download

官网提供两个版本：

版本	说明	适用场景
LTS（长期支持版）	稳定、经过充分测试，提供 30 个月长期维护	✅ 企业项目、生产环境首选
Current（最新版）	包含最新特性，但可能有兼容性问题	尝鲜、测试新功能

⚠️ 企业项目强烈建议选 LTS 版本，稳定性优先，避免踩坑。

选择 Windows Installer（.msi）下载即可，安装包自带 npm，无需单独安装。

---

三、安装 Node.js

双击 .msi 安装包开始安装，以下是需要注意的关键步骤：

3.1 选择安装路径

尽量不要安装在 C 盘，点击 Change 更改安装位置：

3.2 跳过 C/C++ 编译工具

安装过程中会出现一个勾选项，询问是否安装 Tools for Native Modules（C/C++ 编译工具）：

• ❌ 不要勾选 —— 目前阶段不需要编译 C/C++ 原生模块

• 直接点击 Next 即可

  

💡 什么时候才需要勾选？ 当你用到 node-gyp 编译原生 C++ 扩展（如 bcrypt、node-canvas、部分 sharp 版本）时才需要。初学者跳过即可。

3.3 完成安装并验证

安装完成后，打开 PowerShell，执行以下命令：

node -v
npm -v

如果能正确输出版本号（如 v20.x.x 和 10.x.x），说明安装成功！

PS C:\Users\Administrator> node -v
v20.11.0

PS C:\Users\Administrator> npm -v
10.2.4

---

四、环境变量配置（核心重点）

⚠️ 这一步最容易被忽略，也最容易踩坑！ 不配置会导致 C 盘空间被大量占用，还会出现权限拒绝问题。

4.1 创建全局包目录和缓存目录

进入 Node.js 安装目录（如 D:\soft download\Nodejs\），手动创建两个文件夹：

文件夹名	用途
node_global	全局包安装路径（如 npm install -g 装的东西放这里）
node_cache	npm 下载缓存路径

D:\soft\nodejs\
├── node_global\     ← 新建
├── node_cache\     ← 新建
├── node.exe
├── npm.cmd
└── ...

4.2 配置 npm 全局路径和缓存路径

打开命令行窗口，执行以下两条命令（将路径替换为你的实际安装路径）：

npm config set prefix "D:\soft download\Nodejs\node_global"
npm config set cache "D:\soft download\Nodejs\node_cache"

执行后可以通过以下命令验证配置是否生效：

npm config get prefix
npm config get cache

💡 为什么要改？ 默认情况下，npm 全局包安装在 C:\Users\<用户名>\AppData\Roaming\npm，缓存在 C:\Users\<用户名>\.npm。随着时间推移，全局包越来越多，C 盘空间告急，而且某些操作需要管理员权限，容易报 EACCES 错误。

4.3 配置系统环境变量

配置好 node_global 后，必须把它的 bin 子目录加入系统 PATH，否则全局安装的命令行工具（如 cnpm、yarn、vite 等）在终端里会提示"不是内部或外部命令"。

步骤一：打开高级系统设置

右键「此电脑」→ 属性 → 高级系统设置 → 环境变量

步骤二：配置系统变量 PATH

1. 在「系统变量」区域找到 Path，点击「编辑」

2. 点击「新建」，添加 Node.js 安装路径：D:\soft download\Nodejs\

   

3. 再新建一条，添加全局包路径：D:\soft download\Nodejs\node_global

步骤三：修改用户变量 PATH

1. 在「用户变量」区域找到 Path，点击「编辑」

2. 你会看到一条 C:\Users\<用户名>\AppData\Roaming\npm 的路径

3. 将其更改为：D:\soft download\Nodejs\node_global

   

⚠️ 这一步很关键！如果用户变量里还留着旧的 C 盘路径，npm 全局命令仍然会指向旧位置。

步骤四：新建系统变量 NODE_PATH

1. 在「系统变量」区域点击「新建」

2. 变量名：NODE_PATH

3. 变量值：D:\soft download\Nodejs\node_global\node_modules

   

💡 NODE_PATH 的作用： Node.js 在 require() 模块时，会先搜索当前目录的 node_modules，找不到时会沿目录向上查找。设置 NODE_PATH 后，全局安装的模块也可以被直接 require 引用（不推荐在生产代码中这么做，但调试时方便）。

步骤五：保存并验证

点击所有窗口的「确定」按钮保存设置，然后关闭并重新打开命令行窗口（环境变量变更需要重开终端才生效）。

执行全局安装命令验证：

npm install -g cnpm

如果没有报错，并且 cnpm -v 能正常输出版本，说明配置成功！

---

五、配置 npm 国内镜像加速

国内访问 npm 官方源速度较慢，强烈建议配置镜像加速。以下提供几种方案：

方案一：临时使用淘宝镜像

npm install --registry=https://registry.npmmirror.com

方案二：永久设置淘宝镜像（推荐）

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

验证当前源：

npm config get registry

---

六、常见问题与排错

Q1：'npm' 不是内部或外部命令

原因： 环境变量未配置或未重新打开终端。

解决：

1. 检查系统变量 Path 中是否包含 Node.js 安装路径
2. 修改环境变量后，关闭并重新打开命令行窗口

Q2：全局安装包后命令找不到（xxx 不是内部或外部命令）

原因： node_global 路径未加入环境变量。

解决： 将 D:\soft\nodejs\node_global 添加到系统变量 Path 中。

Q3：npm install 报 EACCES 权限错误

原因： 全局安装路径无写入权限。

解决：

1. 确认 npm config get prefix 指向你配置的 node_global 路径
2. 右键文件夹 → 属性 → 安全 → 给当前用户授予完全控制权限
3. 或以管理员身份运行命令行

Q4：安装速度极慢甚至超时

原因： 使用了 npm 官方源，国内访问慢。

解决： 配置淘宝镜像（见第五节）。

Q5：npm ERR! code EJSONPARSE

原因： package.json 文件格式错误（多了逗号、少了引号等）。

解决： 用 JSON 校验工具检查 package.json 语法。

Q6：nvm 切换版本后 npm 失效

原因： nvm 切换版本时，全局 npm 可能未正确链接。

解决：

nvm use 20.11.0
npm install -g npm@latest

环境配置是开发的第一步，也是最重要的一步。配置得当，后续开发事半功倍；配置不当，各种报错会浪费你大量时间。按照本文一步步来，你的 Node.js 开发环境将稳如磐石。

---

欢迎收藏。如有疑问欢迎评论区交流。