本文为 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 主程序按下WinR输入control打开「控制面板」找到「程序和功能」在列表中找到「Node.js」可能显示版本号如 Node.js 20.x.x右键「Node.js」→ 选择「卸载」按照提示一步步完成操作卸载完成后关闭所有终端和 IDE如 VS Code避免进程占用。1.3 删除残留目录卸载主程序后系统中仍会残留部分目录需手动删除否则会导致 NVM 安装后无法正常使用重点删除以下 4 个目录复制路径到文件管理器地址栏可快速定位C:\Program Files\nodejsC:\Program Files (x86)\nodejsC:\Users\你的用户名\AppData\Roaming\npmC:\Users\你的用户名\AppData\Roaming\npm-cache注意事项若找不到「AppData」文件夹需开启「显示隐藏项目」文件管理器顶部 → 查看 → 勾选「隐藏项目」若某个目录不存在直接跳过即可。1.4 清理环境变量右键「此电脑」→「属性」→「高级系统设置」→「环境变量」分别检查「用户变量」和「系统变量」中的Path变量删除所有包含nodejs、npm、node_modules的路径若存在NODE_PATH变量直接删除该变量旧 Node 遗留。点击「应用」→「确定」关闭环境变量窗口。1.5 验证卸载成功重启终端无需管理员执行以下两个命令node -v npm -v✅ 预期结果均提示「不是内部或外部命令也不是可运行的程序或批处理文件」说明旧 Node 彻底卸载成功若仍有版本输出重复上述步骤检查残留目录和环境变量。二、NVM 官网下载与安装核心路径避坑NVM 官网为 GitHub 仓库下载过程中需确保网络正常推荐下载「一键安装版」新手无需手动配置环境变量重点关注路径选择。2.1 官网下载 NVM-windows打开浏览器访问 NVM-windows 官网 GitHub 地址https://github.com/coreybutler/nvm-windows/releases下拉页面找到「Assets」资源板块选择适合 Win11 的安装包✅推荐下载nvm-setup.exe一键安装版新手首选自动配置环境变量❌不推荐nvm-noinstall.zip免安装版需手动配置环境变量容易出错❌不推荐source code源代码需编译不适合新手。点击「nvm-setup.exe」开始下载下载完成后找到安装包通常在「下载」文件夹双击打开。2.2 安装 NVM路径选择是关键安装过程中全程点击「下一步」仅在以下 2 步停留设置路径选择直接决定后续是否会出现激活报错选择 NVM 安装路径强烈建议 注意事项路径必须无空格、无中文、无特殊字符否则会出现权限不足、命令无法识别等问题。选择路径后点击「下一步」。✅首选方案安装到 C 盘默认无空格目录如C:\nvm最稳定避免权限和路径解析问题✅备选方案若必须装 D 盘选择无空格目录如D:\ProgramData\nvm❌禁止选择D:\Program Files\nvm这类带空格的系统目录会导致后续nvm use激活报错。选择 Node.js 符号链接路径 选择路径后点击「Install」等待 1-2 分钟安装完成后点击「Finish」。✅ 推荐路径C:\nodejs或D:\nodejs与 NVM 安装路径一致无空格、无中文说明此路径是 NVM 切换版本时自动创建的快捷方式目录无需手动创建若提示“该目录已存在”删除该目录后再继续安装。2.3 验证 NVM 安装成功必须以管理员身份打开终端关键后续所有 NVM 命令建议用管理员权限执行避免权限问题左下角搜索「CMD」或「PowerShell」右键选择「以管理员身份运行」执行以下命令查看 NVM 版本nvm version✅ 预期结果输出版本号如 1.2.2说明 NVM 安装成功且环境变量配置无误❌ 异常处理若提示「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 本身没有专门的“查看镜像”命令查看镜像是否配置成功唯一正确的方法是打开 NVM 安装目录如C:\nvm或D:\ProgramData\nvm找到「settings.txt」文件双击用记事本打开查看文件末尾若出现以下两行说明镜像配置成功node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/补充若文件中没有这两行重新执行 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 路径选择原则切记首选方案尽量安装到 C 盘默认无空格目录如C:\nvm、C:\nodejs避免权限和路径解析问题这是最稳定、最不易出错的选择。备选方案若必须装 D 盘必须选择无空格目录如D:\ProgramData\nvm、D:\nodejsD:\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按以下步骤迁移即可新建无空格目录如D:\ProgramData\nvm打开 NVM 安装目录下的settings.txt修改root为新目录root: D:\ProgramData\nvm同时确认symlink为无空格路径如D:\nodejs将旧 NVM 目录D:\Program Files\nvm下所有文件包括版本文件夹v*、settings.txt等剪切到新目录修改系统环境变量NVM_HOME将其值从旧路径改为新路径D:\ProgramData\nvm重启终端管理员身份重新执行nvm use 20.18.0激活版本即可解决报错。注意事项迁移过程中不要删除旧目录确认新目录可正常使用后再删除旧目录避免文件丢失。六、附录手动配置 NVM 环境变量异常情况备用若 NVM 安装后执行nvm version提示「不是内部或外部命令」说明环境变量未自动配置手动配置如下右键「此电脑」→「属性」→「高级系统设置」→「环境变量」在「系统变量」中点击「新建」添加以下两个系统变量变量名NVM_HOME变量值NVM 安装目录如C:\nvm或D:\ProgramData\nvm变量名NVM_SYMLINK变量值Node.js 符号链接目录如C:\nodejs或D:\nodejs。找到「系统变量」中的Path点击「编辑」添加以下两个路径- %NVM_HOME% - %NVM_SYMLINK%点击「应用」→「确定」重启终端执行nvm version验证是否生效。七、最终验证与总结7.1 最终验证激活成功后执行以下命令均正常输出版本号即代表环境完全可用nvm version node -v npm -v7.2 总结旧 Node 彻底卸载是前提重点清理残留目录和环境变量避免版本冲突路径选择是核心优先 C 盘无空格目录D 盘必须避开Program Files这类带空格的路径这是本次实操最关键的避坑点镜像配置只执行带地址的命令绝不执行不带参数的镜像命令避免配置被清空所有 NVM 操作建议以管理员身份执行避免权限不足导致的命令失效若已安装到带空格路径按「迁移 NVM 路径」步骤修正无需重装 NVM可快速解决激活报错。按照本文步骤操作可彻底解决「镜像配置清空」「命令用错」「权限不足」「路径空格报错」等问题新手也能零踩坑完成 NVM Node.js 环境配置适用于 Win11 所有版本全程贴合本次实操场景。
Win11 官网安装 NVM 完整教程（含避坑指南+最终修正版）
发布时间：2026/6/23 11:12:51
本文为 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 主程序按下WinR输入control打开「控制面板」找到「程序和功能」在列表中找到「Node.js」可能显示版本号如 Node.js 20.x.x右键「Node.js」→ 选择「卸载」按照提示一步步完成操作卸载完成后关闭所有终端和 IDE如 VS Code避免进程占用。1.3 删除残留目录卸载主程序后系统中仍会残留部分目录需手动删除否则会导致 NVM 安装后无法正常使用重点删除以下 4 个目录复制路径到文件管理器地址栏可快速定位C:\Program Files\nodejsC:\Program Files (x86)\nodejsC:\Users\你的用户名\AppData\Roaming\npmC:\Users\你的用户名\AppData\Roaming\npm-cache注意事项若找不到「AppData」文件夹需开启「显示隐藏项目」文件管理器顶部 → 查看 → 勾选「隐藏项目」若某个目录不存在直接跳过即可。1.4 清理环境变量右键「此电脑」→「属性」→「高级系统设置」→「环境变量」分别检查「用户变量」和「系统变量」中的Path变量删除所有包含nodejs、npm、node_modules的路径若存在NODE_PATH变量直接删除该变量旧 Node 遗留。点击「应用」→「确定」关闭环境变量窗口。1.5 验证卸载成功重启终端无需管理员执行以下两个命令node -v npm -v✅ 预期结果均提示「不是内部或外部命令也不是可运行的程序或批处理文件」说明旧 Node 彻底卸载成功若仍有版本输出重复上述步骤检查残留目录和环境变量。二、NVM 官网下载与安装核心路径避坑NVM 官网为 GitHub 仓库下载过程中需确保网络正常推荐下载「一键安装版」新手无需手动配置环境变量重点关注路径选择。2.1 官网下载 NVM-windows打开浏览器访问 NVM-windows 官网 GitHub 地址https://github.com/coreybutler/nvm-windows/releases下拉页面找到「Assets」资源板块选择适合 Win11 的安装包✅推荐下载nvm-setup.exe一键安装版新手首选自动配置环境变量❌不推荐nvm-noinstall.zip免安装版需手动配置环境变量容易出错❌不推荐source code源代码需编译不适合新手。点击「nvm-setup.exe」开始下载下载完成后找到安装包通常在「下载」文件夹双击打开。2.2 安装 NVM路径选择是关键安装过程中全程点击「下一步」仅在以下 2 步停留设置路径选择直接决定后续是否会出现激活报错选择 NVM 安装路径强烈建议 注意事项路径必须无空格、无中文、无特殊字符否则会出现权限不足、命令无法识别等问题。选择路径后点击「下一步」。✅首选方案安装到 C 盘默认无空格目录如C:\nvm最稳定避免权限和路径解析问题✅备选方案若必须装 D 盘选择无空格目录如D:\ProgramData\nvm❌禁止选择D:\Program Files\nvm这类带空格的系统目录会导致后续nvm use激活报错。选择 Node.js 符号链接路径 选择路径后点击「Install」等待 1-2 分钟安装完成后点击「Finish」。✅ 推荐路径C:\nodejs或D:\nodejs与 NVM 安装路径一致无空格、无中文说明此路径是 NVM 切换版本时自动创建的快捷方式目录无需手动创建若提示“该目录已存在”删除该目录后再继续安装。2.3 验证 NVM 安装成功必须以管理员身份打开终端关键后续所有 NVM 命令建议用管理员权限执行避免权限问题左下角搜索「CMD」或「PowerShell」右键选择「以管理员身份运行」执行以下命令查看 NVM 版本nvm version✅ 预期结果输出版本号如 1.2.2说明 NVM 安装成功且环境变量配置无误❌ 异常处理若提示「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 本身没有专门的“查看镜像”命令查看镜像是否配置成功唯一正确的方法是打开 NVM 安装目录如C:\nvm或D:\ProgramData\nvm找到「settings.txt」文件双击用记事本打开查看文件末尾若出现以下两行说明镜像配置成功node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/补充若文件中没有这两行重新执行 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 路径选择原则切记首选方案尽量安装到 C 盘默认无空格目录如C:\nvm、C:\nodejs避免权限和路径解析问题这是最稳定、最不易出错的选择。备选方案若必须装 D 盘必须选择无空格目录如D:\ProgramData\nvm、D:\nodejsD:\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按以下步骤迁移即可新建无空格目录如D:\ProgramData\nvm打开 NVM 安装目录下的settings.txt修改root为新目录root: D:\ProgramData\nvm同时确认symlink为无空格路径如D:\nodejs将旧 NVM 目录D:\Program Files\nvm下所有文件包括版本文件夹v*、settings.txt等剪切到新目录修改系统环境变量NVM_HOME将其值从旧路径改为新路径D:\ProgramData\nvm重启终端管理员身份重新执行nvm use 20.18.0激活版本即可解决报错。注意事项迁移过程中不要删除旧目录确认新目录可正常使用后再删除旧目录避免文件丢失。六、附录手动配置 NVM 环境变量异常情况备用若 NVM 安装后执行nvm version提示「不是内部或外部命令」说明环境变量未自动配置手动配置如下右键「此电脑」→「属性」→「高级系统设置」→「环境变量」在「系统变量」中点击「新建」添加以下两个系统变量变量名NVM_HOME变量值NVM 安装目录如C:\nvm或D:\ProgramData\nvm变量名NVM_SYMLINK变量值Node.js 符号链接目录如C:\nodejs或D:\nodejs。找到「系统变量」中的Path点击「编辑」添加以下两个路径- %NVM_HOME% - %NVM_SYMLINK%点击「应用」→「确定」重启终端执行nvm version验证是否生效。七、最终验证与总结7.1 最终验证激活成功后执行以下命令均正常输出版本号即代表环境完全可用nvm version node -v npm -v7.2 总结旧 Node 彻底卸载是前提重点清理残留目录和环境变量避免版本冲突路径选择是核心优先 C 盘无空格目录D 盘必须避开Program Files这类带空格的路径这是本次实操最关键的避坑点镜像配置只执行带地址的命令绝不执行不带参数的镜像命令避免配置被清空所有 NVM 操作建议以管理员身份执行避免权限不足导致的命令失效若已安装到带空格路径按「迁移 NVM 路径」步骤修正无需重装 NVM可快速解决激活报错。按照本文步骤操作可彻底解决「镜像配置清空」「命令用错」「权限不足」「路径空格报错」等问题新手也能零踩坑完成 NVM Node.js 环境配置适用于 Win11 所有版本全程贴合本次实操场景。
