如何在Mac系统中升级Node.js？升级后版本不生效如何解决

步骤1：先清理所有冲突的旧Node安装包 #

你遇到的版本回退问题核心是多来源Node安装包冲突，优先清理非nvm安装的所有Node版本：

• 卸载官方pkg安装的Node

sudo rm -rf /usr/local/{lib/node{,/.npm,_modules},bin,share/man}/{npm*,node*,man1/node*}

• 卸载brew安装的Node（如果有）

brew uninstall node --force

• 清理n工具安装的Node缓存（如果用过n）

sudo rm -rf /usr/local/n

步骤2：修复nvm终端持久化配置 #

nvm生效需要在shell配置文件中添加加载脚本，这是绝大多数人关闭终端后版本回退的核心原因：

1. 先确认当前使用的shell类型

echo $SHELL

2. 编辑对应配置文件：
   • 输出为/bin/zsh：编辑~/.zshrc文件
   • 输出为/bin/bash：编辑~/.bash_profile或~/.bashrc文件
3. 将以下内容粘贴到配置文件末尾并保存

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

4. 让配置即时生效

# 对应zsh环境，bash环境替换为你编辑的配置文件路径
source ~/.zshrc

步骤3：安装目标Node版本并设置为默认 #

1. 安装需要的Node版本，例如安装最新长期支持版：

nvm install --lts

你也可以指定具体版本，例如nvm install 20.10.0
2. 将刚安装的版本设置为全局默认版本，避免新终端回退

# 替换为你实际安装的版本号
nvm alias default v20.10.0

验证结果 #

新开终端窗口执行以下命令，确认配置生效：

• 查看版本号：node -v
• 确认Node路径是nvm管理路径：which node，输出应为/Users/你的用户名/.nvm/versions/node/版本号/bin/node格式即为正常。

注意：后续使用npm安装全局包时不要加sudo，避免权限混乱导致版本管理失效。

内容的提问来源于stack exchange，提问作者connected_user