VSCode本身不运行PHP，必须手动配置php.executablePath指向系统中真实php路径；需在.intelephense.json中设置includePaths支持vendor类跳转；Xdebug 3+须配xdebug.mode=debug、start_with_request=yes及launch.json的pathMappings，否则断点失效。
VSCode 本身不运行 PHP，装了扩展也白搭——除非你本地系统里真有 php 命令，且 VSCode 能准确找到它。所有功能（跳转、补全、调试、格式化）都卡在这一步上。
php -v 在终端能跑，但 VSCode 提示“PHP executable not found”
这是最常被忽略的环境变量断层：VSCode 图形界面启动时，不一定继承你在终端里配置好的 $PATH。尤其 macOS（zsh 配置未被 GUI 进程加载）、Windows（PATH 没进系统变量而是只加在用户变量）、Linux（sudo 安装后 php 在 root PATH）三类情况高频出问题。
- 先在终端执行
which php或where php（Windows），拿到绝对路径，比如/opt/homebrew/bin/php或C:\xampp\php\php.exe - 打开 VSCode 设置（
Cmd+,/Ctrl+,），搜索php.executablePath，填入上面那个完整路径（注意 Windows 要带.exe） - 别信“自动检测”——这个字段必须手动填，否则
Intelephense会报PHP language server is not running，Xdebug 断点直接灰掉
装了 PHP Intelephense 却无法跳转到 Composer vendor 类
Intelephense 默认只索引当前工作区，对 vendor/ 下的类库视而不见，除非你告诉它“这些路径也要扫描”。尤其 Laravel、Symfony 等项目依赖大量外部包，不配就等于没装。
- 在项目根目录新建
.intelephense.json（不是 settings.json） - 写入：
{ "environment": { "includePaths": ["./vendor/autoload.php"] } } - 或者更稳妥地，把整个
vendor/加进去："includePaths": ["./vendor"] - 改完后右键命令面板（
Cmd+Shift+P）→ 输入Intelephense: Index workspace手动触发重建索引
Xdebug 断点始终不生效，launch.json 配好了也没用
断点灰色 ≠ 配置漏项，大概率是 Xdebug 3+ 的协议行为变了，而 VSCode 的 PHP Debug 插件没同步适配，或 php.ini 里关键开关关着。
立即学习“PHP免费学习笔记（深入）”；
- 确认
php --ini输出的 Loaded Configuration File 里，已启用xdebug：检查是否存在zend_extension=...行，且路径指向真实的xdebug.so/php_xdebug.dll -
php.ini中必须有这三行（Xdebug 3+）：xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1
-
launch.json中pathMappings不能省——哪怕纯本地开发，也得写："pathMappings": { "${workspaceFolder}": "/var/www/html" }（右边路径可以任意，只要和xdebug.client_host匹配逻辑即可） - 重启 Web 服务（Apache/Nginx）或 CLI 服务（如 PHP内置服务器），让 php.ini 生效
真正卡住人的从来不是“怎么配”，而是“哪一层没生效却没报错”：可能是终端 PATH 和 VSCode 不一致，可能是 .intelephense.json 放错位置，也可能是 xdebug.mode 写成 xdebug.remote_enable=1（那是旧版写法）。每一步都得用对应命令验证，而不是凭感觉点保存就以为成了。
