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

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

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

---

一、前置知识

1. NVM 是什么？

   • NVM 全称 Node Version Manager，顾名思义就是 Node.js 版本管理工具。
   • 它可以让你在同一台电脑上自由切换多个 Node.js 版本，避免不同项目之间的环境冲突。

2. 为什么需要镜像？

   • NVM 默认从 nodejs.org 下载 Node.js 二进制包，国内访问速度比较慢。
   • 通过配置 NVM_NODEJS_ORG_MIRROR 环境变量，可以将下载源切换到国内的镜像站（如淘宝、npmmirror），显著提升下载速度。

---

二、安装 NVM

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

• Windows 用户

  • 推荐使用 nvm-windows
  • 下载 .exe 安装包，一路 Next 即可。

• Linux / macOS 用户

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
  

  安装完成后记得重新打开终端，或者 source ~/.bashrc。

---

三、配置国内镜像源

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

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

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

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

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

---

四、安装 Node.js 22

执行以下命令即可：

nvm install 22

如果需要切换到该版本：

nvm use 22

查看当前 Node.js 版本：

node -v

查看全局 npm 版本：

npm -v

---

五、验证是否安装成功

运行一个简单的 JavaScript 文件：

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

执行：

node test.js

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

---

六、常见问题排查

1. 报错 找不到可用的版本

   • 确认你的 NVM_NODEJS_ORG_MIRROR 设置正确。
   • 可以直接访问 npmmirror Node.js 镜像 查看是否能打开。

2. 安装后 Node.js 无法使用

   • Windows 需要以管理员权限运行命令行。

   • Linux/macOS 确认 nvm.sh 已正确加载，可以在 .bashrc 中添加：

     export NVM_DIR="$HOME/.nvm"
     [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
     

3. 切换版本无效

   • 在 Windows 下，可能需要重新打开终端窗口。
   • 确认 nvm list 输出中已显示对应版本。

---

七、总结

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