XAMPP自带Xdebug但默认禁用，需修改php.ini启用：确保zend_extension路径正确、xdebug.mode=debug、client_port=9003、idekey=PHPSTORM三者与PhpStorm监听端口及浏览器插件设置严格一致，重启Apache后通过phpinfo()验证，并用Xdebug Helper触发调试请求。
php.ini 并重启 Apache 就能启用，关键在路径、端口、IDE key 三者对齐，否则 PhpStorm 完全收不到断点请求。
确认 XAMPP 是否已含 Xdebug 模块
新版 XAMPP（尤其是 8.0+）通常已预装 xdebug.so（macOS/Linux）或 php_xdebug.dll（Windows），位置固定：
- Windows：
D:\XAMPP\php\ext\php_xdebug.dll - macOS：
/Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20220829/xdebug.so（注意目录名中的 PHP API 版本号，如20220829对应 PHP 8.2） - Linux：
/opt/lampp/lib/php/extensions/no-debug-non-zts-20220829/xdebug.so
若 phpinfo() 页面里搜不到 Xdebug，说明模块未加载——不是没装，而是 zend_extension 路径写错了，或版本不匹配（比如 PHP 8.3 用了为 8.1 编译的 xdebug.so）。
修改 php.ini 启用 Xdebug 并配对 PhpStorm
打开 php.ini（XAMPP 控制面板 → Config → PHP (php.ini)），在文件末尾追加以下配置（**不要保留旧的注释行**，避免冲突）：
[XDebug] zend_extension = "/Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20220829/xdebug.so" xdebug.mode = debug xdebug.start_with_request = trigger xdebug.client_host = 127.0.0.1 xdebug.client_port = 9003 xdebug.idekey = "PHPSTORM" xdebug.log = "/Applications/XAMPP/xamppfiles/logs/xdebug.log"
重点说明：
立即学习“PHP免费学习笔记（深入）”；
-
xdebug.mode = debug是 Xdebug 3+ 的新写法，替代旧版的xdebug.remote_enable=1；设为debug即可，不用加profile或trace，否则拖慢响应 -
xdebug.start_with_request = trigger表示只在带XDEBUG_SESSION_START=PHPSTORM参数或浏览器插件激活时才启动调试，避免全局开销 - 端口统一用
9003（Xdebug 3 默认），别再硬写9000—— macOS 上常被系统服务占着，lsof -i :9000一查就露馅 -
xdebug.idekey必须和 Chrome 插件、PhpStorm 里的设置完全一致，大小写敏感，引号不参与匹配
Chrome 插件与 PhpStorm 的联动要点
仅装 Xdebug Helper 不够，必须让它和 PhpStorm “说同一种协议”：
- Chrome 安装 Xdebug Helper 后，右键图标 → Options → IDE Key 选
PHPSTORM（不是填空，是下拉选） - PhpStorm 中：
File → Settings → PHP → Debug→ Xdebug → Port 改为9003；Settings → PHP → Servers添加一个 server，Name 填localhost，Host 填localhost，Port 填 Apache 实际端口（通常是80或8080），Debugger 选Xdebug - 务必点击右上角电话图标（
Start Listening for PHP Debug Connections），变绿才算监听中；它不随项目自动开启 - 访问页面时，必须带触发参数，例如：
http://localhost/test.php?XDEBUG_SESSION_START=PHPSTORM，或直接点浏览器插件图标变绿色再刷新
断点不命中？先查这三处日志和状态
90% 的“调试没反应”问题出在连接链路断裂，按顺序排查：
- 看
xdebug.log文件末尾是否有Connection failed或Could not connect to debugging client—— 八成是 PhpStorm 没开监听，或端口不一致 - 在 PhpStorm 的
Run → Web Server Configuration里确认 URL 映射是否指向你当前访问的路径（比如项目根目录设为G:/PHP，但你访问的是http://localhost/myapp/index.php，则需在 Servers 里把 path mapping 对准） - 运行
php -v和php --ini，确认 CLI 模式加载的是同一个php.ini；Web 模式（Apache）和 CLI 模式可能用不同 ini，导致phpinfo()看到 Xdebug，但 CLI 调试却失败
最易忽略的一点：Xdebug 3 要求 xdebug.mode 显式声明，且 zend_extension 路径不能用相对路径或环境变量——哪怕看着对，复制粘贴进终端用 ls 或 dir 实锤一次。
