如何配置Xdebug以优化PHP调试体验？

本文共计656个文字，预计阅读时间需要3分钟。

确保使用Xdebug 3时，以下代码块中的`xdebug.mode`必须显式启用，否则断点将完全无效。

为什么断点打了却没停？检查 xdebug.mode 是否包含 debug

Xdebug 3 彻底改用模式驱动机制，xdebug.remote_enable 这类旧配置已失效。最常见的情况是：PHP 启动了，Xdebug 扩展也加载了，但 IDE 就是收不到连接。 - xdebug.mode 默认值是 off，不是 debug - 单步调试必须至少包含 debug，例如：xdebug.mode=debug 或 xdebug.mode=debug,develop - 如果还用 xdebug.start_with_request=yes，得确保 debug 在 mode 里，否则该配置无效 - CLI 脚本调试需额外加 XDEBUG_MODE=debug 环境变量，不能只靠 php.ini

VS Code + PHP Debug 插件连不上？重点核对 xdebug.client_host 和端口

VS Code 的 php.debug 插件默认监听 127.0.0.1:9003，但 Xdebug 3 默认连 127.0.0.1:9000，且不自动探测 host。