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 版本,避免冲突
✅ 安装前准备
- 系统版本:Ubuntu 20.04 / 22.04 / 24.04 均适用
- 权限:推荐具备 sudo 权限
需要安装的软件:
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
指定版本即可。
✅ 总结
通过本文你可以做到:
- 安装并验证 NVM
- 安装任意 Node.js 版本
- 使用
.nvmrc
统一项目版本 - 解决常见安装问题
NVM 是学生初学者学习和开发 Node.js 的利器,非常值得掌握!
📝 参考资料
- NVM 官方仓库 ([GitHub][1], [MonoVM.com][8])
- 最新安装脚本推荐来源
- GeeksforGeeks Ubuntu 教程详解 ([GeeksforGeeks][2])
正文到此结束
- 本文标签: nvm
- 本文链接: https://code.itptg.com/article/32
- 版权声明: 本文由老魏原创发布,转载请遵循《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》许可协议授权