VSCode怎么配置PHP调试Xdebug_VSCode如何断点调试PHP程序查看变量值【指南】-VSCode-PHP中文网

xdebug不触发断点最常见的原因是xdebug.mode未设为debug；新版xdebug 3.0+默认关闭所有功能，必须显式配置xdebug.mode=debug，并确认php进程（如fpm/cli）加载了正确php.ini，同时launch.json中pathmappings、idekey等需与环境严格匹配。

vscode怎么配置php调试xdebug_vscode如何断点调试php程序查看变量值【指南】

VSCode里Xdebug不触发断点，`xdebug.mode`设错是最常见原因

新版Xdebug（3.0+）默认关闭所有调试功能，光装扩展、配launch.json没用。必须确认PHP配置里xdebug.mode包含debug，否则请求根本不会连到VSCode。

xdebug.mode=debug 是最低要求；加develop能启用函数跟踪，但会拖慢响应，开发环境慎开
检查生效配置：在PHP里运行 phpinfo() 或执行 php -i | grep xdebug.mode，别只改了php.ini却重启错了PHP进程（如CLI和FPM是两套配置）
Windows下常见坑：WAMP/XAMPP的php.ini可能有两份（apache/目录和php/目录），优先改php.ini所在路径带Loaded Configuration File的那一行指向的文件

`launch.json`里`pathMappings`配错，变量值显示为`undefined`

VSCode找不到PHP文件对应本地路径，就无法把断点位置和变量上下文关联起来——看着停在某行，但$_GET、$user全灰掉或显示undefined。

VSCode 1.118

微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。

下载

关键不是服务器路径，而是Xdebug发来的file://绝对路径和你本地工作区路径的映射关系。比如Xdebug传的是file:///var/www/html/index.php，而你项目开在/Users/me/project，就得写：
```
"pathMappings": {
  "/var/www/html/": "${workspaceFolder}/"
}
```
Linux/macOS注意路径结尾斜杠：映射键必须以/结尾，否则子目录文件匹配失败
用Xdebug Helper浏览器插件点“Debug”时，会带XDEBUG_SESSION_START=PHPSTORM参数——VSCode默认监听vscode，所以launch.json里得加"ideKey": "vscode"，否则连接被拒绝

断点进了但`var_dump()`输出不显示在VSCode调试控制台

这是预期行为：Xdebug调试通道只传变量结构、调用栈、断点状态，不接管echo或var_dump()的标准输出。这些内容照常打到Web响应体或CLI终端里。

想看变量值，直接悬停鼠标在变量名上，或打开“变量”面板——它比var_dump()更准，能展开对象属性、识别引用
如果非要调试时看输出，改用xdebug_info()（Xdebug 3.1+）或xdebug_break()触发断点后手动查，避免污染业务逻辑
注意output_buffering：如果PHP开了缓冲（output_buffering=4096），echo内容会卡住不刷出，容易误判为没执行到

HTTP请求能断，但CLI脚本（如`php artisan`）死活不进断点

CLI模式下Xdebug默认不自动启动，得手动加参数或环境变量，VSCode的launch.json也要换配置类型。

运行命令前加XDEBUG_MODE=debug：例如XDEBUG_MODE=debug php artisan migrate；或者用php -d xdebug.mode=debug artisan migrate
VSCode里选“PHP CLI”配置模板，type设为php，request设为launch，删掉url字段，填对program路径（如"${workspaceFolder}/artisan"）
CLI断点依赖xdebug.start_with_request=yes（Xdebug 3.1+）或xdebug.remote_autostart=1（旧版），否则只靠环境变量不一定生效