vscode报“php executable not found”根本原因是未正确配置php.executablepath绝对路径；需在设置中手动填写如c:/xampp/php/php.exe或/opt/homebrew/bin/php，并同步配置launch.json的runtimeexecutable及pathmappings，重启后生效。
VSCode 报 “PHP executable not found” 不是插件坏了，而是它根本没找到 php 这个可执行文件——路径没配对，所有功能（语法检查、调试、格式化）都会静默失效。
为什么终端能跑 php -v，VSCode 却找不到？
图形界面启动的 VSCode 通常不继承 shell 的 PATH，尤其 macOS/Linux 的 ~/.zshrc 或 Windows 用户变量和系统变量不一致时。它不会自动猜你装在哪，也不会读取你终端里生效的软链。
- 在 VSCode 内置终端运行
which php（macOS/Linux）或where php（Windows），看输出路径是否真实存在 - 如果路径正确但插件仍报错，大概率是启动方式问题：改用命令行启动
code .，避免桌面图标绕过 shell 配置 - 最稳解法：直接填绝对路径，不依赖环境变量
php.executablePath 必须填绝对路径
这个设置控制所有 PHP 相关功能的底层入口，不是可选项，是开关。填错或留空，Intelephense 补全标红、Xdebug 断点灰色、php -l 校验直接跳过——全是因为没 PHP 可调用。
- Windows 常见路径：
C:\xampp\php\php.exe、C:\php\php.exe、E:/phpstudy_pro/Extensions/php/php7.4.3nts/php.exe（注意斜杠统一用/） - macOS Homebrew：
/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel） - Linux 手动编译：
/usr/local/php/bin/php，别只写php - 路径含空格或中文？重装到干净路径，比如
C:\php，比加引号更可靠
PHP Debug 插件也要单独配 runtimeExecutable
即使 php.executablePath 已设好，launch.json 里的调试器仍可能走默认逻辑，尤其你用了 Xdebug 3+ 或自定义 PHP 安装位置时。
- 打开
.vscode/launch.json，在configurations下的 PHP 配置块中，显式加字段："runtimeExecutable": "/opt/homebrew/bin/php"（值必须和php.executablePath一致） - 别漏掉
pathMappings，哪怕本地开发：如果项目在/Users/me/project，Web 服务器看到的是/var/www/html，就得写"${workspaceFolder}": "/var/www/html" - 改完必须重启 VSCode，Intelephense 和 Xdebug 语言服务器会缓存状态，不重启旧配置还在生效
最容易被忽略的点是：CLI 模式和 Web 模式用的 php.ini 是两份。你改了 Apache 的那份，VSCode 调用 CLI 时压根不认——先跑 php --ini 看它实际加载哪份，再编辑那个文件，否则 xdebug.mode=debug 再怎么写也没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
