M1 Mac升级Big Sur后VSCode终端使用错误PHP版本如何解决？

问题根源说明 #

你之前配置的php.validate.executablePath、php.executablePath是给VSCode的PHP插件做语法校验、功能调用使用的，和终端内执行命令调用的PHP版本无关，所以修改这两个参数解决不了终端的问题。问题本质是VSCode终端的PATH环境变量没有优先加载Homebrew的可执行文件路径，导致优先调用了系统自带的旧版PHP。

解决方案 #

按优先级依次尝试以下操作即可：

1. 直接配置VSCode终端环境变量（最快捷）

打开settings.json，保留原有配置的基础上新增以下内容：

{
    // 强制终端PATH优先加载Homebrew路径
    "terminal.integrated.env.osx": {
        "PATH": "/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"
    },
    // 可选：强制终端以登录shell启动，自动加载你的shell配置
    "terminal.integrated.shellArgs.osx": ["-l"]
}

保存后完全关闭VSCode进程，重新打开后新建终端，执行which php验证即可。

2. 补全shell配置文件

如果第一步无效，确认你把Homebrew路径加到了所有会被加载的shell配置中：

• 如果你用的是Mac默认的zsh，依次执行以下两条命令：

echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zprofile

• 如果你用的是bash，依次执行以下两条命令：

echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.bash_profile

执行完成后重启VSCode测试即可。

3. 确认默认终端配置

如果以上操作都无效，在settings.json中添加配置指定默认终端，避免VSCode调用了未配置的其他shell：

"terminal.integrated.defaultProfile.osx": "zsh"

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