如何在 macOS 上使用 NVM 切换 Node.js 版本(分步指南)

在不同 Node.js 版本之间切换可能很棘手。如果你是一名开发者,同时处理多个项目,你很可能需要不同的 Node 版本。Node 版本管理器(NVM)简化了这一过程。本指南将清晰地解释如何安装 NVM、管理多个 Node 版本,以及在 macOS 上解决常见问题。
要点
- NVM 简化了在不同 Node.js 版本之间的切换,避免冲突。
- 确保在终端配置文件中正确加载 NVM。
- 解决与 Homebrew 或全局 npm 配置的常见冲突。
什么是 NVM,为什么要使用它?
NVM 是一个管理多个 Node.js 安装的 shell 脚本。它允许开发者快速切换 Node 版本,而不会影响其他系统组件。当项目需要不同的 Node 环境时,这种灵活性非常有用。
在 macOS 上安装 NVM
按照以下简单步骤在 Mac 上安装 NVM:
- 下载并安装 NVM:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
- 更新 Shell 配置文件:
确认以下行已添加到你的
~/.zshrc
或~/.bash_profile
中:
export NVM_DIR=""$HOME/.nvm""
[ -s ""$NVM_DIR/nvm.sh"" ] && . ""$NVM_DIR/nvm.sh""
[ -s ""$NVM_DIR/bash_completion"" ] && . ""$NVM_DIR/bash_completion""
重新加载你的 shell:
source ~/.zshrc
- 检查安装:
nvm --version
安装最新的 Node.js 版本
安装 NVM 后,你可以轻松管理 Node 版本。
- 最新 LTS 版本:
nvm install --lts
- 最新当前版本:
nvm install node
- 特定 Node 版本:
nvm install 18.17.1
- 列出已安装版本:
nvm list
在 Node.js 版本之间切换
使用 nvm use
切换版本:
nvm use 18
确认当前激活的 Node 版本:
node -v
为新终端设置默认 Node 版本:
nvm alias default 18
解决常见 NVM 问题
NVM 命令未找到
- 通过检查你的配置文件(
~/.zshrc
或~/.bash_profile
)确认 NVM 已正确加载。 - 使用
source ~/.zshrc
重新加载你的配置文件。
Node 版本无法切换(Homebrew 冲突)
检查与 Homebrew 安装的冲突:
which -a node
移除冲突的 Node 安装:
brew uninstall --ignore-dependencies node
NVM 警告(npm prefix
问题)
移除 npm 全局前缀设置:
npm config delete prefix
结论
使用 NVM 简化了在 macOS 上管理多个 Node.js 版本的过程,让你能够轻松切换版本并避免版本冲突。正确的设置和解决常见问题可确保顺畅使用。
常见问题
这通常意味着 NVM 没有在你的 shell 配置文件中正确加载。检查 ~/.zshrc 或 ~/.bash_profile 中的 NVM 设置行,并重新加载 shell。
运行 'nvm uninstall <版本>',将 <版本> 替换为你想要移除的 Node 版本。
是的,NVM 会自动安装与你选择的 Node.js 版本兼容的 npm 版本。
Listen to your bugs 🧘, with OpenReplay
See how users use your app and resolve issues fast. Loved by thousands of developers