Win11 官网安装 NVM 完整教程（含避坑指南+最终修正版）

伞伞悦读
0 阅读10分钟

本文为 Win11 系统专属，全程基于 NVM 官网标准流程，整合旧 Node 彻底卸载、NVM 官网下载安装、国内镜像配置、Node 安装激活全步骤，重点融入本次实操中遇到的核心坑、路径空格问题解决方案，确保每一步都可落地、零踩坑，适合零基础新手和遇到配置问题的同学。

一、前置准备：彻底卸载旧 Node.js（必做！否则冲突）

如果系统之前手动安装过 Node.js，必须彻底卸载，否则会与 NVM 管理的版本冲突，导致后续安装、切换版本失败。

1.1 清空 npm 缓存

以普通权限打开 CMD/PowerShell，执行以下命令，清空本地 npm 缓存，避免卸载后残留缓存影响后续安装：

npm cache clean --force

✅ 预期结果：执行后无输出或提示“cache cleaned”即为成功。

1.2 控制面板卸载 Node.js 主程序

  1. 按下 Win+R，输入 control，打开「控制面板」；
  2. 找到「程序和功能」，在列表中找到「Node.js」（可能显示版本号，如 Node.js 20.x.x）；
  3. 右键「Node.js」→ 选择「卸载」，按照提示一步步完成操作；
  4. 卸载完成后，关闭所有终端和 IDE（如 VS Code） ，避免进程占用。

1.3 删除残留目录

卸载主程序后，系统中仍会残留部分目录，需手动删除，否则会导致 NVM 安装后无法正常使用，重点删除以下 4 个目录（复制路径到文件管理器地址栏可快速定位）：

  1. C:\Program Files\nodejs
  2. C:\Program Files (x86)\nodejs
  3. C:\Users\你的用户名\AppData\Roaming\npm
  4. C:\Users\你的用户名\AppData\Roaming\npm-cache

注意事项：若找不到「AppData」文件夹，需开启「显示隐藏项目」（文件管理器顶部 → 查看 → 勾选「隐藏项目」）；若某个目录不存在，直接跳过即可。

1.4 清理环境变量

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

  2. 分别检查「用户变量」和「系统变量」中的 Path 变量：

    • 删除所有包含 nodejs、npm、node_modules 的路径；
    • 若存在 NODE_PATH 变量，直接删除该变量（旧 Node 遗留）。

  3. 点击「应用」→「确定」，关闭环境变量窗口。

1.5 验证卸载成功

重启终端（无需管理员），执行以下两个命令：

node -v
npm -v

✅ 预期结果：均提示「不是内部或外部命令，也不是可运行的程序或批处理文件」，说明旧 Node 彻底卸载成功；若仍有版本输出，重复上述步骤，检查残留目录和环境变量。

二、NVM 官网下载与安装（核心路径避坑）

NVM 官网为 GitHub 仓库，下载过程中需确保网络正常，推荐下载「一键安装版」，新手无需手动配置环境变量，重点关注路径选择。

2.1 官网下载 NVM-windows

  1. 打开浏览器，访问 NVM-windows 官网 GitHub 地址：github.com/coreybutler…；

  2. 下拉页面，找到「Assets」（资源）板块，选择适合 Win11 的安装包：

    • ✅ 推荐下载：nvm-setup.exe（一键安装版，新手首选，自动配置环境变量）；
    • ❌ 不推荐：nvm-noinstall.zip（免安装版，需手动配置环境变量，容易出错）；
    • ❌ 不推荐：source code（源代码，需编译，不适合新手）。

  3. 点击「nvm-setup.exe」开始下载，下载完成后，找到安装包（通常在「下载」文件夹），双击打开。

2.2 安装 NVM（路径选择是关键！）

安装过程中，全程点击「下一步」，仅在以下 2 步停留设置，路径选择直接决定后续是否会出现激活报错：

  1. 选择 NVM 安装路径（强烈建议） ： 注意事项：路径必须无空格、无中文、无特殊字符，否则会出现权限不足、命令无法识别等问题。选择路径后，点击「下一步」。

    • ✅ 首选方案：安装到 C 盘默认无空格目录，如 C:\nvm（最稳定，避免权限和路径解析问题）；
    • ✅ 备选方案：若必须装 D 盘，选择无空格目录，如 D:\ProgramData\nvm；
    • ❌ 禁止选择：D:\Program Files\nvm 这类带空格的系统目录（会导致后续 nvm use 激活报错）。

  2. 选择 Node.js 符号链接路径： 选择路径后，点击「Install」，等待 1-2 分钟，安装完成后点击「Finish」。

    • ✅ 推荐路径：C:\nodejs 或 D:\nodejs（与 NVM 安装路径一致，无空格、无中文）；
    • 说明：此路径是 NVM 切换版本时自动创建的快捷方式目录，无需手动创建，若提示“该目录已存在”，删除该目录后再继续安装。

2.3 验证 NVM 安装成功

必须以管理员身份打开终端（关键！后续所有 NVM 命令建议用管理员权限执行，避免权限问题）：

  1. 左下角搜索「CMD」或「PowerShell」，右键选择「以管理员身份运行」；
  2. 执行以下命令，查看 NVM 版本：nvm version
  3. ✅ 预期结果：输出版本号（如 1.2.2），说明 NVM 安装成功，且环境变量配置无误；
  4. ❌ 异常处理：若提示「nvm 不是内部或外部命令」，重启电脑后再试（安装程序会自动配置环境变量，重启后生效）；若仍失败，手动配置环境变量（见文末附录）。

三、NVM 配置国内镜像（提速+避坑）

NVM 默认使用国外镜像，下载 Node.js 速度极慢，甚至失败，需配置国内镜像（npmmirror 镜像，稳定且速度快），此步骤包含本次实操核心坑点。

3.1 正确配置镜像命令

在管理员终端中，执行以下两个命令（复制粘贴，确保地址完整，无多余空格）：

# 配置 Node 国内镜像
nvm node_mirror https://npmmirror.com/mirrors/node/
​
# 配置 npm 国内镜像
nvm npm_mirror https://npmmirror.com/mirrors/npm/

✅ 关键说明：执行后没有任何输出是正常的，不要以为是命令失败，只要镜像地址成功写入 NVM 配置文件，即为成功。

3.2 【核心坑！】命令认知错误

❌ 错误认知：之前误以为「nvm node_mirror」「nvm npm_mirror」（不带参数）是「查看镜像」的命令，导致执行后镜像配置被清空。

✅ 真实作用（本次实操验证）：不带参数的「nvm node_mirror」「nvm npm_mirror」，是「重置镜像为默认值」的命令，会直接清空 settings.txt 里的镜像地址！

注意事项：配置完成后，绝对不要执行以下两个命令，否则会清空你的镜像配置，回到初始状态： nvm node_mirror（无参数）、nvm npm_mirror（无参数）

3.3 正确查看镜像配置

NVM-windows 本身没有专门的“查看镜像”命令，查看镜像是否配置成功，唯一正确的方法是：

  1. 打开 NVM 安装目录（如 C:\nvm 或 D:\ProgramData\nvm）；
  2. 找到「settings.txt」文件，双击用记事本打开；
  3. 查看文件末尾，若出现以下两行，说明镜像配置成功： node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/
  4. 补充：若文件中没有这两行，重新执行 3.1 中的配置命令，确保命令正确、终端是管理员权限。

四、使用 NVM 安装、激活 Node.js

镜像配置成功后，即可用 NVM 安装 Node.js，推荐安装 LTS 版本（长期支持版，稳定、兼容性好），步骤如下，全程用管理员终端执行。

4.1 安装 Node.js LTS 版本

执行以下命令，安装指定 LTS 版本（本次实操安装 20.18.0，可根据需求替换版本号）：

nvm install 20.18.0

✅ 正常现象：国内镜像生效后，下载速度极快（几 MB/s），终端会显示下载进度条、解压过程，最终提示「Installation complete」（安装完成）。

❌ 异常处理：若提示「Version '' (with LTS filter) not found」（找不到版本），执行 nvm ls-remote --lts 刷新版本列表，或重新检查镜像配置。

4.2 激活 Node 版本（核心步骤）

安装完成后，需激活该版本，否则终端无法识别 node 和 npm 命令，执行以下命令：

nvm use 20.18.0

✅ 成功提示：终端显示「Now using node v20.18.0 (64-bit)」，说明激活成功。

注意事项：若出现「exit status 1: 'D:\Program'」报错，说明 NVM 或符号链接路径含空格，需按本文「迁移 NVM 路径」步骤修正，无需重装 NVM。

4.3 验证环境

执行以下两个命令，验证 Node.js 和 npm 是否正常可用：

node -v
npm -v

✅ 预期结果：分别输出版本号（如 node v20.18.0、npm 10.8.2），说明 NVM 和 Node.js 环境配置成功，可正常使用。

五、本次实操核心避坑总结（重中之重）

5.1 路径选择原则（切记！）

  1. 首选方案：尽量安装到 C 盘默认无空格目录（如 C:\nvm、C:\nodejs），避免权限和路径解析问题，这是最稳定、最不易出错的选择。
  2. 备选方案：若必须装 D 盘，必须选择无空格目录（如 D:\ProgramData\nvm、D:\nodejs），D:\Program Files 绝对不要选 这类带空格的系统目录，否则会导致 nvm use 激活报错，后续需迁移路径才能解决。

5.2 关键命令避坑

命令作用是否推荐
nvm node_mirror 镜像地址配置 Node 国内镜像（正确用法）✅ 推荐
nvm npm_mirror 镜像地址配置 npm 国内镜像（正确用法）✅ 推荐
nvm node_mirror（无参数）重置 Node 镜像，清空 settings.txt 地址❌ 禁止
nvm npm_mirror（无参数）重置 npm 镜像，清空 settings.txt 地址❌ 禁止
nvm install 版本号安装指定 Node 版本✅ 推荐
nvm use 版本号激活指定 Node 版本✅ 推荐

5.3 迁移 NVM 路径（解决旧路径空格问题）

若已将 NVM 安装到带空格路径（如 D:\Program Files\nvm），无需卸载 NVM，按以下步骤迁移即可：

  1. 新建无空格目录（如 D:\ProgramData\nvm）；
  2. 打开 NVM 安装目录下的 settings.txt，修改 root 为新目录：root: D:\ProgramData\nvm，同时确认 symlink 为无空格路径（如 D:\nodejs）；
  3. 将旧 NVM 目录（D:\Program Files\nvm）下所有文件（包括版本文件夹 v*、settings.txt 等）剪切到新目录；
  4. 修改系统环境变量 NVM_HOME，将其值从旧路径改为新路径（D:\ProgramData\nvm）；
  5. 重启终端（管理员身份），重新执行nvm use 20.18.0 激活版本，即可解决报错。

注意事项：迁移过程中，不要删除旧目录，确认新目录可正常使用后，再删除旧目录，避免文件丢失。

六、附录：手动配置 NVM 环境变量（异常情况备用）

若 NVM 安装后，执行 nvm version 提示「不是内部或外部命令」，说明环境变量未自动配置，手动配置如下：

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

  2. 在「系统变量」中，点击「新建」，添加以下两个系统变量：

    • 变量名：NVM_HOME，变量值：NVM 安装目录（如 C:\nvm 或 D:\ProgramData\nvm）；
    • 变量名：NVM_SYMLINK，变量值：Node.js 符号链接目录（如 C:\nodejs 或 D:\nodejs）。

  3. 找到「系统变量」中的 Path，点击「编辑」，添加以下两个路径：

- `%NVM_HOME%`
​
- `%NVM_SYMLINK%`
  1. 点击「应用」→「确定」，重启终端，执行 nvm version 验证是否生效。

七、最终验证与总结

7.1 最终验证

激活成功后，执行以下命令，均正常输出版本号即代表环境完全可用：

nvm version
node -v
npm -v

7.2 总结

  1. 旧 Node 彻底卸载是前提，重点清理残留目录和环境变量，避免版本冲突；
  2. 路径选择是核心：优先 C 盘无空格目录，D 盘必须避开 Program Files 这类带空格的路径，这是本次实操最关键的避坑点；
  3. 镜像配置只执行带地址的命令，绝不执行不带参数的镜像命令，避免配置被清空；
  4. 所有 NVM 操作建议以管理员身份执行，避免权限不足导致的命令失效；
  5. 若已安装到带空格路径，按「迁移 NVM 路径」步骤修正，无需重装 NVM，可快速解决激活报错。

按照本文步骤操作，可彻底解决「镜像配置清空」「命令用错」「权限不足」「路径空格报错」等问题，新手也能零踩坑完成 NVM + Node.js 环境配置，适用于 Win11 所有版本，全程贴合本次实操场景。

avatar
文章
阅读
粉丝