VSCode安装PHP扩展后端必备VSCode配置PHP开发环境-VSCode-PHP中文网

vscode本身不运行php，必须手动配置php.executablepath指向系统中真实php路径；需在.intelephense.json中设置includepaths支持vendor类跳转；xdebug 3+须配xdebug.mode=debug、start_with_request=yes及launch.json的pathmappings，否则断点失效。

vscode安装php扩展后端必备vscode配置php开发环境

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 等项目依赖大量外部包，不配就等于没装。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在项目根目录新建 .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 --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（那是旧版写法）。每一步都得用对应命令验证，而不是凭感觉点保存就以为成了。