nvm 安装 Node.js 慢?配置国内镜像加速

用 nvm 装 Node(nvm install 20)时卡在下载——因为默认从 nodejs.org(海外)拉二进制。给 nvm 配国内 Node 镜像即可。Linux/macOS 的 nvm 和 Windows 的 nvm-windows 配法不同。

一、nvm(Linux / macOS)

设置环境变量 NVM_NODEJS_ORG_MIRROR 指向国内镜像:

export NVM_NODEJS_ORG_MIRROR=https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/
# 或用 npmmirror:
# export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/

写进 ~/.zshrc / ~/.bashrc 长期生效。之后正常安装:

source ~/.zshrc
nvm install 20        # 走镜像下载
nvm install --lts     # 装最新 LTS

单次指定镜像也可以:

NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/ nvm install 20

二、nvm-windows

nvm-windows 是另一个项目,配法不同。用其内置命令设置镜像:

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

或直接编辑 nvm-windows 安装目录下的 settings.txt,加入:

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

然后:

nvm install 20
nvm use 20

三、装完 Node 后,别忘了 npm 换源

nvm 只负责下 Node 本体;装依赖用的 npm 还要单独换源:

npm config set registry https://registry.npmmirror.com

详见 👉 npm 换源与代理。

四、验证

nvm ls-remote | tail        # 能列出版本说明镜像可达
nvm install 20              # 观察下载速度
node -v && npm -v

常见问题

Q:设了镜像 nvm install 还是慢?

• 确认变量在当前终端生效(echo $NVM_NODEJS_ORG_MIRROR);
• nvm-windows 用户注意用 nvm node_mirror 命令或改 settings.txt,不是环境变量。

Q:nvm ls-remote 列不出版本?

• 镜像地址写错或不可达,换 npmmirror / 清华镜像重试。

Q:装完 node 但 npm install 慢?

• 那是 npm 的事,按方法三换 npm 源。

小结

• Linux/macOS 用 NVM_NODEJS_ORG_MIRROR 环境变量;Windows 用 nvm node_mirror 命令。
• 常用镜像:npmmirror、清华 nodejs-release。
• Node 装好后记得再给 npm 换源,两者是分开的。

---

本文仅供技术学习与研究,请遵守所在国家/地区法律法规。