查看: 274|回复: 1

Windows 下 Node.js 高版本降级方法:使用 nvm-windows 实现版本切换与管理

[复制链接]
发表于 昨天 13:00 | 显示全部楼层 |阅读模式
在开发过程中,有时会遇到 Node.js 版本过高导致某些旧版依赖或项目不兼容的情况。此时需要将已安装的高版本降级为低版本。直接卸载重装虽然可行,但频繁切换版本时效率较低。推荐使用 nvm-windows 工具统一管理 Node.js 版本,支持一键安装、切换和删除。以下基于实际环境演示完整操作流程。

一、彻底清理当前 Node.js 环境

降级前必须完全移除现有的 Node.js 及关联文件,避免残留干扰。

1. 打开命令提示符(Win+R → 输入 cmd → 回车),执行以下命令查看 Node.js 安装路径:
  1. where node
复制代码
记录路径(例如 C:\Program Files\nodejs 或自定义路径)。

2. 关闭所有命令行窗口,手动删除找到的 Node.js 安装目录下的所有文件和文件夹。注意:如果 node.exe 不在根目录,需删除其父目录下全部内容。

3. 通过系统卸载程序进一步清理:点击开始菜单 → 输入“控制面板” → 打开“程序和功能” → 找到“Node.js”条目 → 右键卸载。

完成以上步骤后,重启命令行再次执行 node -v 应提示“'node' 不是内部或外部命令”,说明卸载彻底。

二、安装 nvm-windows 版本管理工具

github 官方仓库地址:https://github.com/coreybutler/nvm-windows/releases 下载 nvm-setup.exe 安装包。注意:安装前建议关闭杀毒软件或防火墙,避免误拦截。

1. 双击运行 nvm-setup.exe,依次进入安装向导:
   - 同意许可协议,点击 Next。
   - 选择 nvm 安装路径。建议放置在磁盘根目录下,且路径不含空格或中文符号。例如 D:\nvm。
   - 设置 Node.js 符号链接路径。该路径用于存放当前使用的 Node.js 版本,同样建议放在根目录下新建文件夹,例如 D:\nodejs。
   - 点击 Install 完成安装。

2. 安装完成后,打开新的命令提示符窗口,验证 nvm 是否生效:
  1. nvm v
复制代码
若返回版本号(如 1.1.12)则安装成功。若提示未找到命令,检查环境变量 PATH 是否包含 nvm 安装路径(通常安装程序会自动添加,可注销或重启系统后重试)。

三、安装并切换 Node.js 低版本

1. 查看所有可下载的 Node.js 版本列表:
  1. nvm ls available
复制代码
输出会包含 LTS 和 Current 版本号,注意部分版本可能未列出全部。

2. 安装指定版本,例如 12.17.0:
  1. nvm install 12.17.0
复制代码
下载完成后会自动安装对应 npm 版本。安装后分别验证:
  1. node -v
  2. npm -v
复制代码
如果 npm 未自动安装,可手动从官网下载对应版本的 npm 包,或尝试安装其他已知稳定的版本。

3. 切换到已安装的版本:
  1. nvm use 12.17.0
复制代码
执行后,当前命令行会话即使用该版本。配合 nvm ls 可查看本地所有已安装版本及当前激活版本(前面带“*”号)。

4. 如需删除某个版本:
  1. nvm uninstall 12.17.0
复制代码
注意原文此处命令书写有误(install 应为 uninstall),请以实际正确命令为准。

四、版本切换注意事项

- 每次切换版本后,建议重新打开一个命令行窗口确认 node -v 输出正确。
- 项目中的 node_modules 缓存不跨版本兼容,切换版本后最好重新执行 npm install。
- 若某个版本安装后 npm 功能异常,可尝试 nvm reinstall-packages <版本号> 重新安装全局包。

五、总结

使用 nvm-windows 管理 Node.js 版本可以避免频繁手动卸载重装,尤其适合需要同时维护多个项目的开发者。核心操作流程为:彻底卸载旧版 → 安装 nvm → 通过 nvm install 添加所需版本 → nvm use 切换。建议将 nvm 安装路径和 Node.js 符号链接路径设在无空格、无中文的磁盘根目录,以减少路径解析异常。

(注:本文基于 nvm-windows 1.1.12 版本编写,功能与界面可能随版本更新略有调整。)
回复

使用道具 举报

发表于 昨天 13:10 | 显示全部楼层

Re: Windows 下 Node.js 高版本降级方法:使用 nvm-windows 实现版本切换与管理

感谢分享这么详细的教程!nvm-windows 确实是 Windows 上管理 Node.js 版本的利器,尤其是对需要同时维护多个项目、或遇到新版兼容性问题的开发者来说能省不少事。 我补充两个小细节供大家参考: - 卸载旧版时,除了控制面板和手动删目录,最好也检查一下 `%APPDATA%\npm` 和 `%APPDATA%\npm-cache` 这两个文件夹,有时残留的全局命令行工具(比如 nodemon、yarn)会干扰后续使用。 - 安装 nvm 后,如果第一次运行 `nvm use` 提示“exit status 1”之类的错误,多半是系统权限问题。可以尝试用管理员身份打开命令提示符再执行,因为 nvm 创建符号链接需要管理员权限。 再次感谢楼主的实操流程,一步步写得很清楚,收藏了!
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-6-14 03:08 , Processed in 0.030704 second(s), 17 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部