XAMPP默认不启用PHP调试，需手动配置php.ini启用Xdebug 3.x、设置xdebug.mode=debug及客户端参数，并重启Apache；IDE须匹配端口（默认9003）、正确映射路径并开启监听，最后通过带XDEBUG_SESSION_START参数的URL验证断点是否生效。
XAMPP默认不启用PHP调试功能，必须手动配置php.ini和Xdebug扩展才能进入断点调试状态。
确认Xdebug是否已安装并启用
XAMPP 8.0+ 版本默认捆绑 Xdebug 3.x，但处于禁用状态。需检查 php.ini 中是否已取消注释以下行：
-
zend_extension=php_xdebug.dll（Windows）或zend_extension=php_xdebug.so（Linux/macOS） - 该行不能出现在
;extension=区域，必须是zend_extension=形式 - 若找不到该行，说明 Xdebug 未被加载；可运行
php --m | findstr xdebug（Windows）或php -m | grep xdebug（macOS/Linux）验证
修改php.ini启用错误显示与调试参数
仅开启 Xdebug 不足以触发 IDE 断点，还需设置关键调试开关和错误报告级别：
- 确保
display_errors = On、error_reporting = E_ALL，否则语法错误可能静默失败 - 添加或修改 Xdebug 3 配置段（推荐放在
php.ini底部）：
zend_extension=php_xdebug.dll xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003 xdebug.log="C: mppphplogsbug.log"
xdebug.client_port 必须与 IDE（如 VS Code、PhpStorm）中监听端口一致，默认为 9003（Xdebug 3 起不再用 9000）VS Code 或 PhpStorm 中配置调试器匹配 XAMPP
IDE 端需明确告诉调试器：PHP 可执行路径在哪、监听哪个端口、项目根目录如何映射：
立即学习“PHP免费学习笔记（深入）”；
- VS Code：在
settings.json中设置"php.debug.executablePath": "C:\xampp\php\php.exe" - VS Code：创建
.vscode/launch.json，确保port与xdebug.client_port一致，且pathMappings指向本地项目路径（如"C:\xampp\htdocs\myapp": "${workspaceFolder}"） - PhpStorm：Preferences → PHP → Servers，添加服务器名称（如
localhost），Base URL 填http://localhost，Path Mapping 中将C: mpphtdocsmyapp映射到你的项目文件夹 - 常见失败点：IDE 启动调试时没点 “Listen for Xdebug”，或浏览器没装 Xdebug Helper 插件且未手动触发调试会话
验证调试是否真正就绪
光看 phpinfo() 显示 Xdebug 已加载，不代表断点能命中。真实可用需三者同时满足：
- Apache 重启后，访问
http://localhost/dashboard/phpinfo.php，搜索 “xdebug.mode”，应显示debug - 在 IDE 中设断点，启动调试监听，再用浏览器访问带
XDEBUG_SESSION_START=PHPSTORM参数的 URL（如http://localhost/myapp/index.php?XDEBUG_SESSION_START=PHPSTORM） - 观察
xdebug.log是否有连接尝试记录；无日志通常意味着客户端（IDE）未监听，或防火墙拦截了9003端口 - Windows 下若用 WSL2 或 Docker，
xdebug.client_host需改为宿主机网关 IP（如192.168.49.1），而非127.0.0.1
最容易被忽略的是 Xdebug 3 的模式切换机制：xdebug.mode=debug 必须显式声明，且不能和其他模式（如 profile、trace）混用；一旦写成 xdebug.mode=debug,develop，部分版本会静默失效。
