Published on

Ubuntu 24.04 安装 NVM 并配置国内镜像（Node.js 多版本管理）

Authors
  • avatar
    Name
    Aldrin
    Twitter

📦 本文适用于希望在 Ubuntu 24.04 64-bit 环境中使用 NVM 管理 Node.js 多版本的开发者，尤其是中国大陆网络环境下的镜像加速配置。

🧰 第一步：下载并安装 NVM

确保已安装 curl：

sudo apt update && sudo apt install curl -y

然后运行官方安装脚本：

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

🧪 第二步：激活 NVM 环境变量

安装完成后，需要重新加载终端配置文件：

source ~/.bashrc    # 若使用 Zsh，请执行 source ~/.zshrc

验证是否安装成功：

nvm --version
# 应输出：0.39.5（或其他对应版本）

🚨 第三步：解决无法获取远程版本的问题

在中国大陆服务器上，执行以下命令可能无响应或空列表：

nvm ls-remote

这通常是因为访问 nodejs.org 的官方源失败。此时你可以手动指定国内镜像源。

🌐 第四步：配置国内镜像（推荐淘宝源）

✅ 临时生效（当前终端）

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

✅ 永久生效（写入 .bashrc）

echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
source ~/.bashrc

然后重新加载配置，并验证：

nvm ls-remote
# ✅ 现在应能正确显示 Node.js 所有可用版本

🚀 第五步：安装 Node.js（推荐 LTS）

nvm install --lts

这会自动安装最新版 LTS 版本（例如 20.x 或 22.x），并将其设置为当前默认版本。

📌 小结

你已成功完成：

  1. 安装 NVM 管理器；
  2. 配置国内镜像加速；
  3. 成功列出并安装 Node.js 版本。

💡 小技巧：你还可以安装多个版本，并快速切换：

nvm install 20
nvm use 20
nvm alias default 20

🎉 到此为止，你的 Node.js 多版本管理环境已经配置完毕，未来切换版本、测试兼容性更方便高效！