原创

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

温馨提示:
本文最后更新于 2025年07月16日,已超过 9 天没有更新。若文章内的图片失效(无法正常加载),请留言反馈或直接联系我

📘 什么是 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. 需要安装的软件

    • curlwget(安装脚本下载器)
    • 可选:build-essentiallibssl-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 lsnvm use 指定版本即可。

✅ 总结

通过本文你可以做到:

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

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


📝 参考资料

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

正文到此结束
本文目录