【分享】NVM-Windows,一款实现多 NodeJs 版本安装和随时切换的一站式工具
最近在维护公司老项目和开发新项目的时候,因为框架的问题老项目需要用低版本的 nodeJs 不然安装和编译过不了,然后新项目用的框架又用不了低版本的,以前都是直接用官方 msi 安装的,这样对我来说就很麻烦,然后我就发现这个 nodeJs 版本管理工具。看了一下没人写过完整的安装指南,那我就写(水)一篇
ps: 在我写这篇安装指南的时候看到有佬友发过可视化的版本( nvm-manager、nvm-Desktop),喜欢可视化的可以看看,NVM-Windows 是终端命令行的~
一、安装前准备
1. 卸载已有 Node.js
若已通过 MSI 安装过 Node.js,请先卸载:
打开 控制面板 → 程序和功能
找到 Node.js,右键卸载
删除残留目录(如果存在):
C:\Program Files\nodejs C:\Users\<你的用户名>\AppData\Roaming\npm
重要:未卸载旧版会导致 nvm 无法正确接管 Node 环境 。
2. 准备安装路径
创建无中文、无空格的目录用于安装 NVM,例如:
D:\NVM创建无中文、无空格的目录用于存放 nodeJs 相关的东西,例如:
/** * nvm映射nodeJs的路径,这是能够指定版本的关键。映射之后里面会多出一个nodeJs的文件链接,指向指定的nodeJs版本文件夹 */
D:\nodeJs\execPath
/** * 缓存和全局包目录 */
D:\nodeJs\node_cache
D:\nodeJs\node_global
/** * 我们安装的各个nodeJs版本目录,比如我安装了 22.13.0 LTS 和 24.9.0 两个版本,就会 v22.13.0 和 v24.9.0 两个文件夹,nvm的文件夹链接就是链接到这里面的某个文件夹,实现多版本切换。 */
D:\nodeJs\nodeJsPackage
路径含空格会导致
nvm use命令失败
二、安装 nvm-windows
1. 下载安装包
访问官方 GitHub Release 页面:
Releases · coreybutler/nvm-windows · GitHub
- 推荐下载:
nvm-setup.exe(图形化安装,自动配置环境变量)
2. 执行安装
- 右键 → 以管理员身份运行
nvm-setup.exe
安装路径:
D:\NVM(或你自定义的路径)选择 NodeJs 链接路径,默认是
C:\nvm4w\nodejs,我们换成上面创建的D:\nodeJs\execPath**(这里因为我已经安装过了,所以会显示链接路径出来,首次是没有的)** 然后点下一步后面的看自己需要自行选择即可,最后点击 Install 完成安装
3. 验证安装
打开 新的终端窗口(必须重启终端),执行:
nvm version
若输出版本号(如 1.2.2),说明安装成功 。
三、关键配置
1. 配置镜像加速(国内必备)
编辑 D:\NVM\settings.txt(nvm 安装目录下),添加或修改:
root: D:\nodeJs\nodeJsPackage
path: D:\nodeJs\execPath\nodejs
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: http://mirrors.tencent.com/npm/
镜像源使用
npmmirror.com(原淘宝 NPM 镜像已停用)。
四、使用 nvm 管理 Node.js
常用命令
| 功能 | 命令 |
|---|---|
| 查看可安装版本 | nvm list available |
| 安装指定版本 | nvm install 24.10.0 |
| 安装 LTS 版本 | nvm install lts |
| 切换版本 | nvm use 24.10.0(如果没有跟着上面的配置来的话需要管理员终端才能执行,因为默认映射的路径是 C:\Program Files\npm,微软要求操作 C:\Program Files 下的东西都需要管理员权限才能执行) |
| 查看已安装版本 | nvm list |
示例:安装并使用 Node.js 18
# 安装
nvm install 24.10.0
# 切换
nvm use 24.10.0
# 验证
node -v # 输出 v24.10.0
npm -v # 输出对应版本 配置 npm 全局路径与缓存(仓库我选择了腾讯镜像,阿里有些包更新不及时。使用 pnpm 代替 npm)
npm config set prefix "D:\nodeJs\node_global"
npm config set cache "D:\nodeJs\node_cache"
npm config set registry http://mirrors.tencent.com/npm/
npm config set strict-ssl false
npm install -g pnpm
验证配置:
npm config list
配置系统环境变量
用户变量 PATH 中添加:
D:\nodeJs\node_global(可选)新建用户变量
NODE_PATH:D:\nodeJs\node_global\node_modules
此步骤确保全局命令(如
yarn,vue)可在任意终端使用 。
然后你就拥有一个了 多版本共存、无权限烦恼、下载飞快 的 Node.js 开发环境了!


