Node 安装教程 Windows：从零开始的详细安装与配置指南

如果你是第一次在 Windows 上安装 Node.js，或者之前装过但总是报错、找不到命令、npm 不能用，这篇教程会一步一步带你把 Node 安装教程 Windows 这件事彻底弄明白。
下面内容会尽量讲得通俗，适合新手直接照着做。

---

一、先搞清楚：Node.js 是什么

Node.js 不是一个普通软件，它本质上是一个运行环境。
很多前端工具、开发框架、打包工具，比如：

• Vue
• React
• Vite
• Webpack
• TypeScrIPt
• Electron

都需要先装 Node.js，才能继续安装依赖、运行项目。

简单理解就是：
Node.js = 让电脑能跑 JavaScript 开发工具的基础环境。

---

二、安装前要准备什么

在 Windows 上装 Node.js，建议先确认这几件事：

1. 确认系统版本

一般 Windows 10、Windows 11 都没问题。
如果是特别老的系统，比如 Windows 7，虽然部分旧版本 Node 还能装，但不建议继续使用，兼容性和安全性都比较差。

2. 确认系统位数

大多数电脑现在都是 64 位系统。
你可以这样查看：

• 右键“此电脑”
• 点“属性”
• 看“系统类型”

如果显示“64 位操作系统”，那就直接下载 64 位版本即可。

3. 先准备一个稳定网络

因为后面安装包、npm 依赖包都可能需要联网下载，网络不稳定容易导致安装失败或者依赖报错。

---

三、Node.js 官方安装方法

这是最推荐的方法，最省事，也最适合新手。

第一步：去官网下载安装包

打开 Node.js 官方网站，下载 Windows 版本安装包。

下载时一般会看到两个版本：

• LTS 版本
• Current 版本

建议选哪个？

如果你是新手，或者只是做前端开发、运行常见项目，优先选 LTS 版本。
这个版本稳定，兼容性好，踩坑少。

---

第二步：运行安装程序

双击下载好的 .msi 安装文件，然后按提示操作。

安装过程中一般会出现几个选项：

1. 接受协议

勾选同意，继续下一步。

2. 选择安装路径

默认路径一般是：

C:\Program Files\nodejs\

新手建议直接用默认路径，不要乱改。
如果你电脑系统盘空间紧张，也可以改到其他盘，但后续排查问题时要记住路径。

3. 组件选择

默认勾选即可，一般包括：

• Node.js runtime
• npm package manager
• 相关辅助功能

不要随便取消，直接下一步。

4. 安装附加工具

安装时可能会问你要不要安装一些额外的构建工具。
比如某些老项目在 Windows 上编译依赖时会用到 Python、Visual Studio Build Tools。

新手怎么选？

• 如果只是入门学习、跑普通前端项目：可以先不装
• 如果你以后要装一些带原生编译模块的依赖：建议勾选

---

四、安装完成后怎么检查是否成功

安装完不要急着关，先验证一下。

方法一：用命令提示符检查

按下：

Win + R

输入：

cmd

回车，打开命令提示符。

然后输入：

node -v

如果安装成功，会显示版本号，比如：

v20.11.0

再输入：

npm -v

如果也显示版本号，说明 npm 也正常。

---

五、如果提示“不是内部或外部命令”怎么办

这是新手最常见的问题之一。
一般原因只有几个：

1. 没有安装成功

先回头检查安装包是否完整，重新安装一次。

2. 环境变量没有配置好

Node 安装时通常会自动配置环境变量，但有时会失败。

你可以手动检查：

查看环境变量路径

• 右键“此电脑”
• 点击“属性”
• 打开“高级系统设置”
• 点击“环境变量”
• 找到系统变量里的 Path

确认里面有没有类似下面的路径：

C:\Program Files\nodejs\

如果没有，就手动添加进去。

添加方法

• 点“新建”
• 输入 Node 安装目录
• 保存后一路确定
• 重新打开命令提示符再试

---

六、npm 是什么，为什么也要检查

很多人以为装完 Node 就结束了，其实还要看 npm 是否可用。

npm 的作用

npm 是 Node.js 自带的包管理工具。
你可以把它理解成“软件安装器”，很多前端库都靠它安装。

例如：

npm install

或者：

npm install -g @vue/cli

这些命令都离不开 npm。

验证 npm

输入：

npm -v

如果能看到版本号，说明没问题。

---

七、推荐的安装方式：用版本管理工具

如果你经常要切换不同 Node 版本，比如：

• 旧项目要 Node 14
• 新项目要 Node 18 或 20
• 某些工具对版本要求不同

那只装一个固定版本很容易冲突。
这时候建议用 nvm for Windows。

---

八、nvm for Windows 安装方法

这是 Windows 下管理多个 Node 版本的常用工具。

1. 下载 nvm for Windows

注意：Windows 上用的是 nvm for Windows，不是 Linux/MACOS 上那个原版 nvm。

2. 安装 nvm

运行安装包后，默认一路下一步即可。
安装时会让你选择：

• nvm 安装目录
• nodejs 软链接目录

建议默认即可，方便管理。

3. 安装指定版本 Node

打开命令行，输入：

nvm install 20.11.0

安装完成后切换：

nvm use 20.11.0

查看当前版本：

node -v

4. 查看已安装版本

nvm list

适合谁用？

• 前端开发者
• 多项目开发人员
• 经常切换环境的人

如果你只是临时学一下，直接装官方版就够了。
如果你以后准备长期做开发，nvm 会更省心。

---

九、Node 安装后常见问题处理

---

问题 1：node 能用，npm 不能用

这种情况通常是安装不完整，或者 PATH 变量有问题。

解决办法：

1. 打开环境变量
2. 检查 nodejs 目录是否在 Path 里
3. 重新打开命令行
4. 再执行：

node -v
npm -v

---

问题 2：安装后版本很旧

如果你下载的是旧安装包，版本可能偏老。

解决办法：

• 去官网重新下载最新的 LTS 版本
• 或者用 nvm 直接切换新版本

---

问题 3：npm 安装依赖特别慢

这是很多国内用户都会遇到的问题，原因通常是默认源在国外，访问慢。

解决办法：切换 npm 镜像源

可以临时改为国内镜像，比如常见的淘宝镜像。

查看当前源：

npm config get registry

设置镜像源：

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

设置后再查看一次：

npm config get registry

如果显示新地址，就说明改成功了。

---

问题 4：安装依赖时报错“权限不足”

有些人把项目放在系统盘保护目录下，比如桌面、C 盘某些特殊目录，可能会触发权限问题。

解决办法：

• 把项目放到普通目录，比如：
  • D:\project\
  • E:\code\
• 不要放在系统保护很强的目录里
• 以普通用户身份运行即可，尽量不要长期用管理员模式开命令行

---

问题 5：安装时卡住或报网络错误

通常是网络、代理、杀毒软件拦截导致的。

解决办法：

• 换稳定网络
• 临时关闭第三方安全软件的过度防护
• 检查是否开了错误的代理
• 换 npm 镜像源

---

十、安装完成后建议做的基础配置

1. 更新 npm

有时 Node 装好后，npm 版本比较旧，可以升级一下：

npm install -g npm

如果升级报错，也可以先不管，很多时候不影响使用。

---

2. 设置全局包安装位置

如果你经常全局安装工具，比如 vue-cli、pnpm、yarn，建议把全局目录规划清楚，避免权限问题。
不过对新手来说，先默认使用系统安装方式就行，没必要一开始就复杂化。

---

3. 安装常用工具

如果你是前端开发，可以后续装这些：

npm install -g pnpm
npm install -g yarn

不过现在很多项目更推荐 pnpm，速度快，空间占用更省。

---

十一、推荐的新手安装方案

如果你不想折腾，直接按下面这个方案最稳：

方案一：只装官方 LTS 版

适合：

• 初学者
• 临时使用
• 不想管理多个版本的人

操作：

1. 下载 LTS
2. 默认安装
3. 检查 node -v
4. 检查 npm -v
5. 设置 npm 镜像源

方案二：nvm 管理多个版本

适合：

• 长期开发
• 多项目环境
• 经常切换版本的人

操作：

1. 安装 nvm for Windows
2. 用 nvm install 安装指定版本
3. 用 nvm use 切换
4. 用 node -v 验证

---

十二、一个最实用的安装检查清单

你可以按这个顺序快速确认是否装好：

安装后检查

node -v
npm -v

如果命令无效

• 检查是否安装成功
• 检查环境变量
• 重新打开命令行窗口

如果下载慢

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

如果要多版本管理

• 使用 nvm for Windows

---

十三、给新手的避坑建议

1. 不要随便装太多版本

同一台电脑装多个 Node 版本，如果不用版本管理工具，很容易乱。

2. 不要乱改环境变量

环境变量一旦改错，常见现象就是命令失效、程序找不到路径。

3. 不要把项目放奇怪路径

尽量用简单路径，比如：

D:\code\myproject

不要放到带中文、空格特别多、权限复杂的目录里，省去很多麻烦。

4. 不要忽略 npm 源

很多人装完 Node 后以为没问题，结果一装依赖就卡半天，其实换源往往就好了。

---

十四、总结：Windows 上安装 Node.js 的正确思路

如果你是新手，记住一句话就够了：

优先安装 Node.js 官方 LTS 版本，安装后用 node -v 和 npm -v 验证，再根据需要切换 npm 镜像源。

如果你后面需要做多个项目、切换不同版本，那么就直接上 nvm for Windows，会更方便。

---

十五、最简操作步骤回顾

1. 去 Node.js 官网下载 LTS 版本
2. 双击安装，默认路径安装
3. 打开 cmd
4. 输入：

node -v
npm -v

5. 如果慢，执行：

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

6. 如果需要多版本管理，安装 nvm for Windows

---

这篇 node安装教程 windows 的核心其实很简单：
装对版本、配好环境变量、确认 npm 可用、必要时切换镜像源。
只要这四步没问题，后面装 Vue、React、Vite、TypeScript 都会顺很多。