GoPick

请在浏览器里打开

微信里打不开这个页面

  1. 1复制下面这个网址
  2. 2粘贴到浏览器打开

也可以在右上角 ··· 里选「在浏览器中打开」

NVM 下载安装:两个项目要两个 Node 版本,来回重装?一条命令切过去

NVM 是 Node 版本管理器。不同项目要求的 Node 版本经常打架,一个要这款、一个要那款,装个 NVM 之后一条命令来回切,不用反复卸载重装。Windows 上用的是 nvm-windows,跟 macOS 上那个 nvm 是两套不同的东西,命令有差别,别照搬。

下载地址
链接来自网盘,打开后直接保存到自己的网盘即可

一、NVM 下载安装教程:它是干什么的#

Node.js 的版本迭代很快,而且不同项目对版本的要求经常互斥。一个三年前的老项目锁在 Node 16,一个新项目要求 20 以上,两个都要维护,你就得在「卸了装、装了卸」之间反复折腾。

NVM 解决的就是这件事:它把每个 Node 版本装在自己的目录里,然后动态切换命令行里的 node 指向哪一个。切过去、切回来,各自的环境互不干扰。

工作方式很朴素:

D:\nvm\               ← NVM 的根目录
├── v18.20.4\         ← 一个完整的 Node 18
├── v24.22.2\         ← 一个完整的 Node 24
├── v26.13.0\         ← 一个完整的 Node 26
└── settings.txt      ← 镜像、根路径等配置

nvm use 后面跟版本号,做的事是把命令行的 node、npm 指向那个版本所在的文件夹。

先分清两个「NVM」#

nvm-windowsnvm(nvm-sh)
平台WindowsmacOS / Linux
安装方式exe 安装包一行 curl 脚本
装 LTS 的命令nvm install ltsnvm install --lts
默认版本不支持 nvm alias default支持

网上搜到的教程十有八九是 macOS/Linux 版,命令直接抄过来会报错。这篇讲的是 Windows 版。

要不要装? 只用一两个项目、版本要求一致,那直接装官方 msi 更简单,不用多一层。手上同时维护几个不同年代的项目、或者要测试包在不同 Node 版本下的兼容性,才需要它。

二、下载#

三、安装步骤#

  1. 双击文件名里带 x64-setup 的那个(实测本包就是 nvm-2.0.1-x64-setup.exe),弹 UAC 点「是」:
NVM-1
NVM-1
  1. 许可协议页:先点选「I accept the agreement」,Next 才会亮,点 Next:
NVM-2
NVM-2
  1. 接下来几页是 Node 存储位置、运行模式(Shim/Link)、偏好设置,都可以直接用默认值,一路 Next:
NVM-3
NVM-3
  1. 安装程序会问要不要把 NVM 加进系统 PATH,选「是」。
  2. 如果电脑上已经用官方 msi 装过 Node,安装程序会先把那套处理掉。 这一步是必要的——两套东西都往 PATH 里写 node,不清理的话后面 nvm use 切了也没反应。提前把正在跑的项目停掉,别在安装过程中编译东西。
  3. 点「安装」,几秒完成,点「完成」。
  4. 关掉所有已经打开的命令行窗口,重新开一个。安装时改的 PATH 对老窗口不生效。

验证#

nvm version

输出一个版本号就装好了(实测 2.0.1):

NVM-4
NVM-4
nvm root

这行会告诉你 NVM 把 Node 装在哪。后面找配置文件、清缓存都要用到这个路径,先记下来。

配镜像(国内必做)#

不配镜像的话,nvm install 从官方源下载,速度慢且容易断在半路。两条命令:

nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

执行完 nvm root 打开那个目录,里面会多出一个 settings.txt,能看到这两行已经被写进去了。

镜像地址末尾的斜杠不能省,少了会拼出错误的下载地址。

四、费用与授权#

nvm-windows 是 MIT 协议的开源项目,免费,没有商业版。

没有激活码、没有功能限制、不联网校验。它只是个调度器,负责下载和切换版本,本身不包含 Node 的任何商业组件。

Node.js 本身也是 MIT 协议免费开源的,这一点跟 NVM 无关——就算你不用 NVM,直接装官方包也一样免费。

五、第一次用:装一个版本,切过去#

看看有哪些版本可装#

nvm list available

输出一张表格,列出所有能装的 Node 版本,按 LTS、Current、Old stable 分类。表格里带 LTS 标记的就是长期支持版。

装一个 LTS#

nvm install lts

注意 Windows 版没有那两个横杠,写成 --lts 会报错。

想装指定版本就写全版本号:

nvm install 26.13.0

也可以只写大版本号 nvm install 24,它会挑这个系列里最新的一个。

切换版本#

nvm use 26.13.0

成功的话会输出一行 Now using node v版本号 (64-bit)。如果报「拒绝访问」或者「exit status 1」,用管理员身份重开命令行再执行——切换版本要动符号链接,需要提权。

切完验证:

node -v
npm -v

看看装了几个,当前用哪个#

nvm list

带 * 的那一行是当前生效的版本。

卸载某个版本#

nvm uninstall 18.20.4

六、装完能干的几件事#

给不同项目配不同版本。 在项目根目录放一个 .nvmrc 文件,内容写版本号,进目录后执行 nvm use 加那个版本号。Windows 版不会自动读这个文件,还是得手敲,但文件本身是个提醒。

临时关掉 Node。 nvm off 会把 PATH 里的 Node 摘掉,nvm on 恢复。想验证「某个报错是不是 Node 引起的」,用这个比卸载快。

换回官方源。 镜像更新滞后的少数情况下,把 node_mirror 改回 https://nodejs.org/dist/,装完需要的版本再改回来。

清理不再用的版本。 nvm list 看一眼,用 nvm uninstall 一个个删。每个 Node 版本占 100MB 左右,攒十几个就是 1G 多。

检查全局包归属。 每个 Node 版本的全局包是独立的——在旧版本下装的 npm install -g 工具,切到新版本之后就没了,得重装。版本隔离本来就是这个效果,不是坏了。 用 npm list -g --depth=0 看当前版本下装了哪些。

七、几个会踩的坑#

「nvm use 报 exit status 1 或拒绝访问。」

权限不够。用管理员身份打开命令行再执行。如果管理员也不行,检查杀毒软件是不是拦截了符号链接操作——部分安全软件会把「创建链接」当成可疑行为,把 NVM 目录加进白名单。

「切了版本,node -v 还是老版本。」

三个原因,按顺序排查:一是命令行窗口没重开;二是 PATH 里还有一个手动装的 Node,用 where node 看全部匹配路径,把多余的删掉;三是 NVM 根目录被设在了受保护路径下,nvm root 确认一下,改回用户目录。

「nvm install 卡在下载,或者报 SSL 错误。」

镜像没配或者配错了。重新执行一遍 nvm node_mirror,注意末尾斜杠。公司网络需要代理的话,NVM 本身不走系统代理设置,得在命令行里先 set HTTP_PROXY= 指定。

「提示 nvm install --lts 不是有效命令。」

抄了 macOS 的教程。Windows 版是 nvm install lts,没有横杠。

「装完 NVM,原来的项目跑不起来了。」

原来的全局包不在新版本里。切回原来那个 Node 版本,或者在新版本下重新 npm install -g 一遍需要的工具。这是版本隔离的代价,不是故障。

「nvm list available 报错或者列表是空的。」

连不上官方版本列表接口。配好 node_mirror 之后重试;如果还是空,检查 DNS 和防火墙,部分网络环境下 Node 的官方分发域名访问不稳定。

「想设一个默认版本,开机就生效。」

Windows 版没有 nvm alias default。 折中办法:把常用的版本 nvm use 一次,NVM 通常会在下次开机时记住上次的选择;不记住的话,写一个开机脚本执行 nvm use 版本号。

「C 盘空间被 Node 吃掉了。」

所有版本都堆在 nvm root 那个目录下。nvm list 清点,nvm uninstall 删掉不用的。另外每个版本的 npm 缓存也在各自目录里,删版本时会一起清掉。

装完先 nvm list 看一眼现有版本,再决定第一个要装哪个。