使用brew upgrade node升级Node后版本未更新如何解决

• 先定位当前终端实际调用的Node路径，执行：

  which node
  

  Homebrew安装的Node默认路径：Intel芯片Mac为/usr/local/bin/node，M系列芯片Mac为/opt/homebrew/bin/node。如果输出结果和上述路径不匹配，说明系统优先加载了其他渠道安装的Node——常见来源包括官网pkg安装包、nvm/n/fnm等版本管理工具安装的版本，核心原因是PATH环境变量的优先级配置错误。

• 修复PATH优先级问题
  按自己使用的shell编辑对应配置文件：zsh对应~/.zshrc，bash对应~/.bash_profile或~/.bashrc，把Homebrew的bin目录配置写到PATH变量的最前面，保证系统优先读取Homebrew安装的程序：

  • M系列芯片添加配置行：export PATH="/opt/homebrew/bin:$PATH"
  • Intel芯片添加配置行：export PATH="/usr/local/bin:$PATH"
    保存后执行source 你编辑的配置文件路径，让配置立即生效。

• 修复Homebrew软链异常
  如果which node输出的是Homebrew对应路径，但版本显示还是v16.14.2，说明Homebrew的软链指向错误，执行以下命令重新链接Node：

  brew unlink node && brew link node
  

  执行时如果报权限错误，按终端输出的提示修复对应目录权限后重跑命令即可。

• 清理旧版本Node残留
  如果确认v16.14.2是之前通过官网pkg安装包装的，先确认which node输出的是旧版本路径（通常是/usr/local/bin/node），再执行以下命令删除旧版本残留文件：

  sudo rm -rf /usr/local/bin/node
  sudo rm -rf /usr/local/lib/node_modules
  sudo rm -rf /usr/local/include/node
  sudo rm -rf /usr/local/share/man/man1/node.1
  

• 处理版本管理工具冲突
  如果本地装了nvm、n这类Node版本管理工具，直接通过工具设置默认Node版本即可，比如nvm执行以下命令：

  nvm install 18
  nvm alias default 18
  

• 验证结果
  关掉当前终端，新开一个终端窗口执行node -v，正常就会输出v18.4.0。

补充说明：brew upgrade node时输出的Warning: node 18.4.0 already installed仅代表Homebrew的本地安装目录下已经存了18.4.0版本的包，不代表这个版本已经被正确链接到系统可执行路径、能被终端优先调用。

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