brew切换PHP版本时php -v始终返回php@5.6无法切到8.1如何解决

• 定位当前php命令的实际指向
  执行命令：
  which php
  如果输出路径不是brew的管理路径（通常为/home/linuxbrew/.linuxbrew/bin/php），说明存在硬编码路径配置或别名覆盖了brew的软链接。

• 排查清理旧版本硬编码配置
  执行以下命令搜索所有常见shell配置文件中与php@5.6相关的配置行：
  grep -n "php@5.6\|php5.6" ~/.bashrc ~/.zshrc ~/.profile ~/.bash_profile ~/.bash_aliases 2>/dev/null
  根据输出的文件名和行号，打开对应文件，删除或在行首加#注释掉指定php@5.6路径的export PATH配置行。
  额外执行alias | grep php检查别名，如果存在将php指向php@5.6路径的别名，同步在对应配置文件中删除该别名配置。

• 重建brew版本软链接
  依次执行以下命令清理旧链接，强制绑定php@8.1：

brew unlink php@5.6
brew unlink php
brew link php@8.1 --force --overwrite

不要直接执行brew link php，必须明确指定php@8.1版本避免链接到错误版本。

• 生效配置并验证
  执行对应shell的配置重载命令：bash环境执行source ~/.bashrc，zsh环境执行source ~/.zshrc，也可以直接关闭当前WSL终端重新打开。
  最后执行php -v，确认输出为PHP 8.1版本即修复完成。

补充：PATH环境变量按从左到右的优先级匹配可执行文件，如果修复后仍异常，执行echo $PATH确认brew的bin目录（/home/linuxbrew/.linuxbrew/bin）排在所有自定义PHP路径的最前端即可。

内容的提问来源于stack exchange，提问作者m-a lavoie