在 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 版本,实现“永久切换”。