Node.js 常见问题

nvm 安装 Node 慢

nvm 默认从官方站点拉取 Node 二进制（Windows 上的 nvm-windows 还会从 GitHub 拉配套的 npm 压缩包）。国内网络慢时，把镜像改成 npmmirror（原淘宝 npm 镜像）。

Windows 上常用的是 nvm-windows，Linux、macOS 上常用的是 nvm-sh。

nvm-windows（Windows）

安装目录下的 settings.txt（常见路径 %AppData%\nvm\settings.txt）增加或改成：

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

也可以用命令写入同一文件：

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

不带 URL 再执行一次，会恢复官方地址。

nvm-sh（Linux、macOS）

写入 ~/.bashrc 或 ~/.zshrc，再 source 一次：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

只对当前命令生效也可以：

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

切换 npm 下载源

修改 npm registry，只影响 npm install 拉包，不会加快 nvm install。

方案一： 安装时临时指定源。

npm install -g nrm --registry=https://registry.npmmirror.com

方案二： 改用户级默认源。

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

切回官方：

npm config set registry https://registry.npmjs.org

也可以在项目根目录的 .npmrc 里写 registry=https://registry.npmmirror.com，只覆盖当前项目。

方案三： 用 nrm 在多个源之间切换。

npm install -g nrm --registry=https://registry.npmmirror.com
nrm ls
nrm use taobao
npm config get registry

较新的 nrm 里，taobao 已指向 https://registry.npmmirror.com/。若 nrm ls 仍显示 registry.npm.taobao.org，先升级 nrm，或手动改别名：

nrm del taobao
nrm add taobao https://registry.npmmirror.com
nrm use taobao

注意： Yarn、pnpm 各有自己的 registry 配置，只改 npm 不会带动它们。需要时分别执行 yarn config set registry、pnpm config set registry。