🧩 使用 NVM 管理 Node.js 版本【适用于 macOS 与 Ubuntu】

🌈 本教程适用于 macOS(含 Intel 与 Apple Silicon 芯片)和 Ubuntu(Debian/类 UNIX 系统均可)。
NVM(Node Version Manager)是一款用于安装、卸载、切换 Node.js 和 npm 多版本的命令行工具。


📦 1. 安装 NVM

🔧 在终端中运行以下命令以下载安装 NVM ⬇️

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

✅ 上面安装的是 v0.40.2(当前最新版),你也可以前往 NVM 官方 GitHub 🔗 查看最新版本。


⏬ 载入 NVM(无需重启终端)

安装完成后让 NVM 生效:

Bash 用户(macOS / Ubuntu)

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

然后建议:

source ~/.bashrc

Zsh 用户(macOS 默认)

source ~/.zshrc

💡你也可以直接关闭终端再重开,NVM 自动加载。


✅ 验证安装是否成功

nvm --version

显示版本号即表示安装成功 🎉


🚀 2. 使用 NVM 安装与管理 Node.js

🆕 安装最新稳定版本

nvm install node

📌 安装特定版本(示例 v14.17.0)

nvm install 14.17.0

✨ 查看已安装版本列表

nvm ls

🔄 切换到某个版本

nvm use 14.17.0

⛳ 设置默认版本(终端启动默认使用此版本)

nvm alias default 14.17.0

🛠 3. 实用命令参考表

命令 作用
nvm install 版本号 安装指定版本 Node.js
nvm uninstall 版本号 卸载已安装指定版本
nvm use 版本号 切换到某个版本
nvm alias default 版本号 设置默认版本
nvm list 查看当前已安装版本列表
nvm ls-remote 显示远程所有可用的 node 版本
node -v / npm -v 查看当前 node 和 npm 的版本

🔙 4. NVM 卸载(如需移除)

1️⃣ 删除 NVM 安装目录:

rm -rf ~/.nvm

2️⃣ 清理终端配置文件中的 NVM 加载代码

  • Bash 用户编辑 ~/.bashrc
  • Zsh 用户编辑 ~/.zshrc

删除如下类似内容:

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

3️⃣ 刷新环境变量或重启终端:

source ~/.bashrc    # bash 用户
source ~/.zshrc     # zsh 用户

✅ 教程总结

项目 支持情况
macOS Intel ✅ 完美兼容
macOS M1/M2 (ARM) ✅ 完美支持(推荐配合 Rosetta)
Ubuntu / Debian ✅ 全流程适配
安装方式 curl 安装脚本一致
环境变量加载逻辑 bash / zsh 均已覆盖
多版本切换/卸载功能 命令无差异

🎯 小贴士

  • 推荐使用 LTS 版本:nvm install --lts
  • 如果你使用 zsh,在安装完之后最好编辑 ~/.zshrc 把 NVM 加载写进去,否则可能自动加载失败
  • 如果你使用的是图形终端(如 iTerm2、Windows Terminal WSL),记得 source 配置文件使 NVM 生效
作者:freed  创建时间:2025-03-28 14:19
最后编辑:freed  更新时间:2025-03-28 14:24