【NodeJS】使用 NVM 安装 Node.js 22 并配置国内镜像加速

使用 NVM 安装 Node.js 22 并配置国内镜像加速

在前端开发或全栈开发中，Node.js 是绕不开的核心环境。但由于网络原因，直接使用 nvm install 安装 Node.js 往往会遇到下载缓慢甚至失败的问题。本文将手把手带你使用 NVM (Node Version Manager) 配置国内镜像源，并快速安装 Node.js 22 最新版本。

一、前置知识

NVM 是什么？
- NVM 全称 Node Version Manager，顾名思义就是 Node.js 版本管理工具。
- 它可以让你在同一台电脑上自由切换多个 Node.js 版本，避免不同项目之间的环境冲突。
为什么需要镜像？
- NVM 默认从 nodejs.org 下载 Node.js 二进制包，国内访问速度比较慢。
- 通过配置 NVM_NODEJS_ORG_MIRROR 环境变量，可以将下载源切换到国内的镜像站（如淘宝、npmmirror），显著提升下载速度。

二、安装 NVM

如果你还没有安装 NVM，可以按照以下步骤：

Windows 用户
- 推荐使用 nvm-windows
- 下载 .exe 安装包，一路 Next 即可。
Linux / macOS 用户
bash 复制代码
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
```
安装完成后记得重新打开终端，或者 source ~/.bashrc。

三、配置国内镜像源

Windows 系统下，可以在 CMD / PowerShell 中运行：

bash 复制代码

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

Linux / macOS 系统，可以写入到 ~/.bashrc 或 ~/.zshrc 中：

bash 复制代码

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

保存后执行 source ~/.bashrc 生效。

四、安装 Node.js 22

执行以下命令即可：

bash 复制代码

nvm install 22

如果需要切换到该版本：

bash 复制代码

nvm use 22

查看当前 Node.js 版本：

bash 复制代码

node -v

查看全局 npm 版本：

bash 复制代码

npm -v

五、验证是否安装成功

运行一个简单的 JavaScript 文件：

javascript 复制代码

// test.js
console.log("Hello, Node.js " + process.version);

执行：

bash 复制代码

node test.js

如果输出类似 Hello, Node.js v22.6.0（版本号视具体安装情况而定），说明安装成功。

六、常见问题排查

报错 找不到可用的版本
- 确认你的 NVM_NODEJS_ORG_MIRROR 设置正确。
- 可以直接访问 npmmirror Node.js 镜像查看是否能打开。
安装后 Node.js 无法使用
- Windows 需要以管理员权限运行命令行。
- Linux/macOS 确认 nvm.sh 已正确加载，可以在 .bashrc 中添加：
  bash 复制代码
```
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
```
切换版本无效
- 在 Windows 下，可能需要重新打开终端窗口。
- 确认 nvm list 输出中已显示对应版本。

七、总结

使用 NVM 可以灵活管理 Node.js 版本。
配置 NVM_NODEJS_ORG_MIRROR 后，可以大大加快 Node.js 的下载速度。