nvm无法拉取Node 22版本列表的镜像刷新与升级方法

脚本专家

nvm 看不到 Node 22、执行 nvm install lts/jod 或 nvm install 22 失败时，原文给出的排查方向有两个：一是 nvm 本地缓存老旧，没有拉取到新版 Node 22 的版本列表；二是 nvm 版本过低，识别不了 Node 22 LTS 代号 lts/jod。处理顺序应是先配置国内镜像并强制刷新远程列表，再安装 Node 22 LTS，最后切换版本并设为默认；如果仍然无法识别 lts/jod，再升级 nvm 后重复刷新和安装。

一、配置 Node 镜像

NVM_NODEJS_ORG_MIRROR 用于指定 Node.js 二进制下载镜像，原文使用 npmmirror 镜像。把环境变量写入 ~/.zshrc 后执行 source 重载，使当前 shell 会话立即生效：

2. echo "export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node" >> ~/.zshrc
3. source ~/.zshrc

复制代码

二、强制刷新远程 Node 版本列表

配置镜像后执行 nvm ls-remote，强制拉取远程全部 Node 版本列表。原文说明，执行完成后列表末尾会出现 v22.x、lts/jod。若列表中没有这些条目，应优先检查 nvm 版本是否过旧，并进入后面的兜底升级步骤：

2. nvm ls-remote

复制代码

三、安装 Node 22 LTS

刷新出 Node 22 相关条目后，安装方式二选一。方式 1 使用官方 lts/jod 标签安装 Node 22 LTS；方式 2 直接按 22 大版本安装最新版本：

2. # 方式1：官方lts标签
3. nvm install lts/jod
4. # 方式2：直接安装22大版本最新
5. nvm install 22

复制代码

四、切换版本并设为默认

安装完成后，用 nvm use 22 切换到 Node 22，用 nvm alias default 22 将默认版本指向 22，最后通过 node -v 校验当前 Node 版本：

2. nvm use 22
3. nvm alias default 22
4. node -v

复制代码

五、兜底方案：升级 nvm

如果 nvm ls-remote 能看到版本，但安装时仍不认识 lts/jod，原文指出最常见原因是 nvm 版本太低。此时按原文命令升级 nvm 到 v0.39.7，重载 zsh 配置后，再重新执行“刷新列表 + 安装 Node 22”：

2. curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
3. source ~/.zshrc

复制代码

六、快速完整执行脚本

原文给出的完整流程如下，按顺序完成镜像配置、nvm 升级、版本列表刷新、Node 22 安装、默认版本设置和版本校验：

2. # 1. 配置国内镜像
3. echo "export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node" >> ~/.zshrc
4. source ~/.zshrc
5. # 2. 更新nvm
6. curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
7. source ~/.zshrc
8. # 3. 拉取最新版本列表
9. nvm ls-remote
10. # 4. 安装node22
11. nvm install 22
12. # 5. 设置默认
13. nvm use 22
14. nvm alias default 22
15. node -v

复制代码

从原文命令可以看出，配置目标是 zsh，因此写入和重载的都是 ~/.zshrc。排查时可按这个顺序定位：先看 nvm ls-remote 是否列出 v22.x 或 lts/jod；没有就先配置镜像并刷新列表；列表有但安装 lts/jod 报错，就升级 nvm；安装成功后用 nvm use、nvm alias default 和 node -v 完成切换、默认版本设置与结果确认。