VS Code调试PHP必须配置Xdebug，因其本身无PHP调试能力；路径映射（pathMappings）错误是90%失败主因，需根据SCRIPT_FILENAME和运行环境（本地/php -S/Docker）精准设置；Xdebug 3需用xdebug.mode=debug与xdebug.start_with_request=yes等新参数，旧remote_*已失效。
PHP调试在VS Code里根本不用装Xdebug扩展？
不是必须。VS Code本身不带PHP调试能力，但xdebug或php-debug（基于Xdebug）仍是当前最稳定、兼容性最好的选择。PHP 8.0+用户如果只用var_dump和error_log，那确实可以跳过配置——但断点、单步、变量监视这些功能，绕不开Xdebug。别信“纯VS Code零配置调试”的说法，那是把日志当调试。
为什么launch.json里pathMappings总配错？
这是90% PHP调试失败的根源。VS Code运行的是本地代码，而Xdebug连接的是PHP进程（可能是本机php -S，也可能是Docker容器），路径对不上就找不到文件。关键看$_SERVER['SCRIPT_FILENAME']实际值，再反推映射：
- 本地开发用
php -S localhost:8000：设"pathMappings": { "/": "${workspaceFolder}/" } - Docker中PHP容器挂载
/app，宿主机是./src：写"pathMappings": { "/app": "${workspaceFolder}/src" } - Windows用户注意斜杠方向，
Xdebug返回的是/var/www/html/index.php这种Unix路径，别硬套C:\project\
xdebug.mode=debug和xdebug.start_with_request=yes有什么区别？
PHP 8.1+ Xdebug 3之后，旧的xdebug.remote_enable全废了。这两个参数决定“谁来触发调试”：
-
xdebug.mode=debug只是启用调试模块，不自动启动会话 -
xdebug.start_with_request=yes才让每个HTTP请求都主动连VS Code（适合Web调试） - 命令行脚本调试要加
php -dxdebug.mode=debug -dxdebug.start_with_request=yes script.php，否则launch.json里的"request": "launch"不会生效 - 如果同时开多个项目，建议用
xdebug.start_with_request=trigger，配合浏览器插件手动触发，避免端口冲突
Chrome插件Xdebug Helper为啥没反应？
它只是发一个XDEBUG_SESSION_START=PHPSTORM的Cookie，VS Code默认监听的是VSCODE IDE key。必须改两处：
立即学习“PHP免费学习笔记（深入）”；
- 在
launch.json里加"ideKey": "VSCODE"（默认就是这个，但有人删了） - 浏览器插件设置页把IDE key从
PHPSTORM改成VSCODE - 确认
xdebug.client_host指向正确——Docker里不能填localhost，得用host.docker.internal（Mac/Win）或宿主机IP（Linux） - 用
phpinfo()页面搜Xdebug，看到Enabled且Mode含debug才算真正加载成功
xdebug.remote_*参数只会静默失效。最省事的办法：在PHP项目根目录跑php -v确认Xdebug版本，然后直接去https://xdebug.org/wizard粘贴phpinfo()输出，它会生成精准的ini片段。 
