如何在 macOS 上使用 nvm永久切换 Node.js 版本

202 阅读2分钟

在 macOS 上使用 nvm(Node Version Manager)永久切换 Node.js 版本,需要将指定版本设置为默认版本。以下是详细步骤:


✅ 1. 确保已安装 nvm

首先,确认你已经安装了 nvm。在终端中运行:

nvm --version

如果没有输出或提示命令未找到,请先安装 nvm

# 使用 curl 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完成后,重启终端 或 执行:

source ~/.zshrc

注意:macOS 默认 shell 是 zsh,所以配置会写入 ~/.zshrc


✅ 2. 查看已安装的 Node 版本

nvm list
# 或
nvm ls

这会列出你当前通过 nvm 安装的所有 Node 版本。


✅ 3. 安装你需要的 Node 版本(如果还没安装)

nvm install 18.17.0   # 举例:安装 Node 18
nvm install 20.10.0   # 安装 Node 20

✅ 4. 永久切换 Node 版本(关键步骤)

要让某个 Node 版本在每次打开终端时自动生效,必须使用:

nvm alias default <version>

例如,你想永久使用 Node 18:

nvm alias default 18.17.0

或者使用别名(如 lts/*):

nvm alias default lts/gallium  # Node 16 LTS
nvm alias default lts/hydrogen # Node 18 LTS

default 是 nvm 的特殊别名,表示默认版本,每次新终端启动时会自动加载。


✅ 5. 验证是否生效

关闭终端,重新打开,然后运行:

node -v

应该显示你设置的默认版本,如 v18.17.0

你也可以运行:

nvm current

查看当前使用的 Node 版本。


✅ 6. (可选)确保 nvm 在终端启动时加载

检查 ~/.zshrc 文件中是否包含 nvm 的初始化脚本:

nano ~/.zshrc

确保文件末尾有类似内容(通常安装时会自动添加):

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载补全

如果没有,请手动添加,然后保存并运行:

source ~/.zshrc

✅ 总结:永久切换的命令

# 安装某个版本
nvm install 18.17.0

# 设置为默认(永久)
nvm alias default 18.17.0

# 验证
node -v  # 应该输出 v18.17.0

这样,无论你重启终端多少次,都会自动使用你设置的 Node 版本,实现“永久切换”。