引路者👇

一、角色分工（30 秒看懂）

二、安装 nvm（Windows 版）

三、换国内镜像（必做，提速 10 倍）

四、一键安装 Node & npm

五、环境变量排雷（90% 报错根源）

六、nvm 常用命令速查

七、一条龙验证（最后一步）

八、踩坑清单（2025 版）

九、总结

---

一、角色分工（30 秒看懂）

工具	作用	关系
nvm	Node 版本切换器	管理 Node.js
Node.js	JavaScript 运行时	自带 npm，但版本可能旧
npm	包管理器（随 Node 附带）	下载、发布、运行脚本

一句话：nvm 管 Node，Node 带 npm，npm 管包。

---

二、安装 nvm（Windows 版）

1. 下载
   官网 https://nvm.uihtm.com/doc/download-nvm.html → 选 nvm-setup.exe（2025-07 最新 1.2.6）。

2. 安装
   双击 → 接受协议 → 路径建议

   • nvm 根目录：D:\nvm

   • Node 快捷目录：D:\nvm\nodejs
     ① 绝对 不要中文、空格；② 结尾不要带 \。

3. 验证
   Win+R → cmd → 输入

   nvm v

   返回 1.2.6 即成功。

---

三、换国内镜像（必做，提速 10 倍）

找到安装目录 → 打开 settings.txt → 末尾追加（任选一组）：

# 淘宝
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

# 清华（备用）
node_mirror: https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/
npm_mirror: https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/npm/

保存后立即生效，后续 nvm install 会走国内源。

---

四、一键安装 Node & npm

# 查看可安装版本
nvm list available

# 装 LTS（推荐生产）
nvm install 20.14.0

# 装最新尝鲜
nvm install 22.3.0

# 切换版本
nvm use 20.14.0

# 验证
node -v   # v20.14.0
npm -v    # 10.x

---

五、环境变量排雷（90% 报错根源）

若出现
“‘node’ 不是内部或外部命令”，按下面 3 步检查：

1. 用户变量
   NVM_HOME = D:\nvm
NVM_SYMLINK = D:\nvm\nodejs

2. 系统变量 → Path
   必须包含

   • %NVM_HOME%

   • %NVM_SYMLINK%

3. npm 全局路径（可选，可建可不建）
   新建文件夹

   D:\nvm\node_global
   D:\nvm\node_cache

   执行

   npm config set prefix "D:\nvm\node_global"
   npm config set cache "D:\nvm\node_cache"

   再把 D:\nvm\node_global 加入系统 Path。

---

六、nvm 常用命令速查

命令	说明
nvm list / nvm ls	已装版本
nvm use 版本号 [32/64]	切换版本
nvm install latest	装最新稳定版
nvm uninstall 版本号	卸载
nvm arch	查看系统位数
nvm proxy 地址	设代理（公司内网）
nvm root	查看 nvm 根路径

---

七、一条龙验证（最后一步）

新开 管理员 PowerShell：

nvm use 20.14.0
node -v
npm -v
npm install -g yarn
yarn -v

全部返回版本号 → 安装完成，可开始搬砖！

---

八、踩坑清单（2025 版）

现象	解决
安装后 nvm 不是命令	重启终端 / 重启电脑，让 Path 生效
nvm use 提示乱码	用 管理员 身份运行终端
npm 装包慢	再配一次 npm 淘宝镜像：
VSCode 终端识别不到 node	重启 VSCode，或把 D:\nvm\nodejs 手动加到 Settings → Terminal → Path

---

九、总结

1. 先装 nvm → 换镜像 → 再装 Node，顺序别反。

2. 路径 0 中文 0 空格，环境变量 重启才生效。

3. 一台电脑可共存 N 个 Node 版本，随切随用。

祝你一次成功，永不重装！
如果仍有报错，把完整截图发评论区，FLY在线答疑。