Ubuntu 环境下安装 NVM：学生初学者指南 🚀

📘 什么是 NVM？

NVM（Node Version Manager）是一个基于 Bash 的版本管理工具，用于安装、切换、卸载多个 Node.js 版本，特别适合多个项目需要不同 Node 版本的场景 ([GitHub][1])。

🧩 为什么要在 Ubuntu 安装 NVM？

• Ubuntu 默认只提供一个 Node.js 版本，常常过时
• npm 全局安装会影响到多个项目
• NVM 可以在项目间自由切换 Node 版本，避免冲突

✅ 安装前准备

1. 系统版本：Ubuntu 20.04 / 22.04 / 24.04 均适用

2. 权限：推荐具备 sudo 权限

3. 需要安装的软件：

   • curl 或 wget（安装脚本下载器）
   • 可选：build-essential、libssl-dev（编译一些源码包时可能会用到） ([GeeksforGeeks][2], [ALexHost SRL][3])

sudo apt update
sudo apt install curl build-essential libssl-dev -y

🛠 安装 NVM

Ubuntu 安装 NVM 最简单、官方推荐的方法：

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

方法一：官方 GitHub 源 (推荐)
这是标准的安装方法，直接从 NVM 的官方 GitHub 仓库下载并执行安装脚本。

# 注意：v0.40.1 是脚本中的示例版本号。
# 建议访问 NVM GitHub 仓库 ([https://github.com/nvm-sh/nvm](https://github.com/nvm-sh/nvm)) 查看最新的稳定版本号，并替换下面的版本号。
curl -o- [https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh](https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh) | bash

方法二：国内 Gitee 镜像源 (备选方案)
如果您在访问 GitHub 时遇到网络问题（例如 curl 命令报错“连接被拒绝”或下载速度过慢），可以尝试使用国内 Gitee 上的镜像。

# 从 Gitee（国内的Git托管平台）下载并执行 NVM-CN 提供的安装脚本
bash -c "$(curl -fsSL [https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh](https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh))"

建议先用 curl -o- … > install.sh 查看脚本内容再执行 ([digitalocean.com][4])

安装结束后，刷新 Shell 配置：

source ~/.bashrc
# 如果使用 Zsh，执行 source ~/.zshrc

然后验证安装是否成功：

nvm --version

输出版本号即可。

🧑‍🎓 使用 NVM 管理 Node.js

🍀 安装最新版本

nvm install node

🏆 安装当前 LTS 版本

nvm install --lts

🎯 安装指定版本

nvm install 16.20.0

🔁 查看已安装版本

nvm ls

🔄 切换版本

nvm use 16.20.0

🎯 设置默认版本

nvm alias default 16.20.0

这样，每次开启新终端，会默认使用该版本。

🧭 高级玩法：项目级 .nvmrc

在项目根目录创建 .nvmrc 文件，内容写入指定版本，例如：

16.20.0

之后进入项目目录，执行：

nvm use

NVM 会自动读取 .nvmrc 切换到该版本，更方便团队一致性使用。

⚠️ 常见问题 & 解决办法

• nvm: command not found
  重新 source ~/.bashrc 或关闭重开终端，确保安装脚本正确写入配置文件 ([自由码农][5], [TecAdmin][6], [4Geeks][7])
• Node 或 npm 无法使用
  可能是未使用 nvm use 切换版本。查看 nvm ls 并 nvm use 指定版本即可。

✅ 总结

通过本文你可以做到：

1. 安装并验证 NVM
2. 安装任意 Node.js 版本
3. 使用 .nvmrc 统一项目版本
4. 解决常见安装问题

NVM 是学生初学者学习和开发 Node.js 的利器，非常值得掌握！

📝 参考资料

• NVM 官方仓库 ([GitHub][1], [MonoVM.com][8])
• 最新安装脚本推荐来源
• GeeksforGeeks Ubuntu 教程详解 ([GeeksforGeeks][2])