Win11 重装系统(保留个人文件/应用)后 NVM、Node、npm 环境恢复教程(新手友好·官方版)

0 阅读5分钟

本文专为 Win11 系统 设计,针对「重装系统时选择保留个人文件和应用」的场景,全程基于 NVM 官网标准流程,用最直白的语言、最详细的步骤,教新手恢复 NVM、Node、npm 环境,无需重装 NVM 和 Node,避开所有常见坑,确保全程零难度、可落地。

核心前提:重装系统后,你之前安装的 NVM(路径如 D:\ProgramData\nvm)、Node(路径如 D:\nodejs)文件都还在,只是系统“忘记”了它们的位置,我们只需重新配置系统识别路径、修复权限即可,不用重新下载安装。

一、前期准备(新手必看,30秒搞定)

  1. 确认你的 NVM 和 Node 安装路径(关键!记好这两个路径,后续全程用到):
  • NVM 安装路径(示例,以你实际路径为准):D:\ProgramData\nvm(本文全程用这个路径演示,你替换成自己的即可)
  • Node 符号链接路径(示例):D:\nodejs
  1. 打开「管理员终端」(全程必须用管理员身份,否则会报错):
  • 左下角点击「开始菜单」,搜索「Windows 终端」;
  • 右键「Windows 终端」,选择「以管理员身份运行」(弹出提示点「是」即可)。

二、核心步骤:恢复环境变量(系统识别路径的关键)

这一步是核心!重装系统后,环境变量会被清空,我们需要重新告诉系统“NVM 和 Node 在哪个文件夹”,步骤全程鼠标操作,不用记复杂命令。

2.1 打开系统环境变量设置

  1. 按键盘「Win + R」,弹出“运行”窗口;
  2. 输入「sysdm.cpl」(直接复制粘贴,不用手动输),点击「确定」;
  3. 弹出「系统属性」窗口,点击顶部「高级」选项卡;
  4. 点击右下角「环境变量」,进入环境变量设置页面(分“用户变量”和“系统变量”,我们只操作「系统变量」)。

2.2 新建 2 个系统变量(告诉系统 NVM 和 Node 的位置)

在「系统变量」区域,点击「新建」,依次创建两个变量,全程复制粘贴,避免输错。

新建第一个变量(NVM 路径)

  1. 变量名:复制粘贴 → NVM_HOME
  2. 变量值:复制粘贴你自己的 NVM 安装路径(示例)→ D:\ProgramData\nvm
  3. 点击「确定」,第一个变量创建完成。

新建第二个变量(Node 路径)

  1. 再次点击「新建」;
  2. 变量名:复制粘贴 → NVM_SYMLINK
  3. 变量值:复制粘贴你自己的 Node 符号链接路径(示例)→ D:\nodejs
  4. 点击「确定」,第二个变量创建完成。

2.3 把两个路径添加到 Path(系统能直接找到命令)

  1. 在「系统变量」区域,找到「Path」变量(字母 P 开头,很好找),点击「编辑」;
  2. 弹出「编辑环境变量」窗口,点击右侧「新建」;
  3. 输入第一个路径 → %NVM_HOME%(复制粘贴,百分号不要漏),点击「确定」;
  4. 再次点击「新建」,输入第二个路径 → %NVM_SYMLINK%(复制粘贴),点击「确定」;
  5. 回到「环境变量」和「系统属性」窗口,依次点击「确定」,保存所有设置(切记不要中途关闭,否则设置无效)。

三、检查 NVM 配置文件(避免后续报错)

这一步很简单,确保 NVM 配置文件和我们的路径一致,避免后续激活 Node 报错。

  1. 打开「文件资源管理器」,在地址栏粘贴你的 NVM 安装路径(示例)→ D:\ProgramData\nvm,按回车;
  2. 在文件夹里找到「settings.txt」文件(用记事本打开,双击即可);
  3. 确保文件内容和下面一致(重点看前两行,路径和你的一致即可):

root: D:\ProgramData\nvm(你的 NVM 安装路径)

symlink: D:\nodejs(你的 Node 符号链接路径)

node_mirror: npmmirror.com/mirrors/nod…

npm_mirror: npmmirror.com/mirrors/npm…

  1. 若内容不一致,直接修改成上面的样子,保存后关闭记事本即可(修改后记得保存,否则无效)。

四、修复 PowerShell 权限(解决 npm 报错问题)

重装系统后,系统会禁止运行脚本,而 npm 是脚本文件,不修复权限会导致「npm -v」报错,这一步只需执行一条命令。

  1. 回到之前打开的「管理员终端」(如果关闭了,重新按步骤打开);
  2. 复制粘贴下面的命令,按回车执行(不用修改,直接复制):
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
  1. 执行后没有任何提示,就是成功了(不用慌,这是正常现象)。

五、激活 Node 版本,验证环境恢复成功

这一步是最后一步,验证所有配置都生效,NVM、Node、npm 都能正常使用。

  1. 还是在「管理员终端」里,执行第一条命令(查看已安装的 Node 版本):
nvm list
  • 执行后会显示你之前安装的 Node 版本(比如 v20.18.0),记好这个版本号。
  1. 执行第二条命令(激活 Node 版本,把版本号换成你自己的):
nvm use 20.18.0
  • 提示「Now using node v20.18.0 (64-bit)」,就是激活成功了。
  1. 执行三条验证命令,全部输出版本号,就是环境完全恢复了:
nvm version  # 验证 NVM 版本
node -v      # 验证 Node 版本
npm -v       # 验证 npm 版本

六、新手避坑指南(重中之重,必看)

  1. 全程必须用「管理员终端」,普通终端会提示权限不足、命令无效;
  2. 环境变量的路径必须和你实际的 NVM、Node 路径一致,复制粘贴不要漏字符;
  3. 执行权限命令时,不要修改命令,直接复制粘贴,避免输错符号;
  4. 若激活 Node 时提示“路径不存在”,检查 settings.txt 里的路径是否正确,或重新确认环境变量配置;
  5. 所有步骤完成后,若命令仍无效,重启电脑再试(环境变量需要重启生效)。

七、总结(新手友好版)

其实整个恢复过程就3个核心:告诉系统 NVM 和 Node 在哪(配置环境变量)、确保 NVM 配置正确、修复 npm 运行权限,全程不用重新下载安装,跟着步骤点鼠标、复制命令,5-10分钟就能搞定。

环境恢复后,你就可以正常使用 npm 安装依赖、运行项目,用 NVM 切换 Node 版本啦,和重装系统前的状态完全一样~