Xdebug 3.x 是 PHP 8.0+ 唯一兼容版本，旧参数如 xdebug.remote_enable 会导致静默失效；必须设置 xdebug.mode=debug、xdebug.client_port=9003，并确保 zend_extension 路径、PHP ABI 及 pathMappings 映射准确无误。
php.ini 里写错配置项，Xdebug 就不加载
新版 XAMPP（含 PHP 8.0+）默认用 Xdebug 3.x，xdebug.remote_enable=1 这类旧参数已完全失效，写了也不报错，但 php -m 看不到 xdebug，phpinfo() 里也搜不到模块——这是最隐蔽的失败原因。
-
xdebug.mode=debug是唯一启用调试的开关，必须显式设置，不能省略 -
xdebug.start_with_request=yes才能免加?XDEBUG_SESSION_START=1参数，否则每次都要手动拼 URL -
xdebug.client_port=9003必须和 VS Code 的launch.json中port值严格一致，9000 已被弃用，别照抄老教程 - Windows 下路径要用正斜杠或双反斜杠：
zend_extension="E:/XAMPP/php/ext/php_xdebug-3.2.2-8.1-vc15-x86_64.dll"，单反斜杠会解析失败
VS Code 的 pathMappings 映射错，断点永远不命中
VS Code 不知道你代码在服务器上跑在哪，pathMappings 就是告诉它“服务器上的 /htdocs/ 对应我本地的 ${workspaceFolder}/”。映射错，断点就只是个装饰品。
- XAMPP 默认 Web 根目录是
E:/XAMPP/htdocs/（Windows）或/opt/lampp/htdocs/（Linux/macOS），左边必须填这个绝对路径，不能写./或htdocs/ - 如果项目不在
htdocs下（比如放在E:/myproject），Apache 虚拟主机指向了它，那左边就得填E:/myproject/，不是/myproject/ - 右边
${workspaceFolder}/是 VS Code 当前打开文件夹的路径，确保你是在项目根目录下打开的 VS Code - 路径末尾都带斜杠，
"/htdocs/"和"${workspaceFolder}/"—— 少一个都可能映射失败
PHP 版本、TS/NTS、VC 编译器三者不匹配，扩展根本加载不了
执行 php -v 输出里藏着两个关键信息：PHP 8.1.25（版本号）和 Thread Safety => enabled（即 TS）。缺一不可，错一个，php -m 就看不到 xdebug，错误日志里只有一行 PHP Warning: Cannot load module 'xdebug'。
- 去 xdebug.org/download 下载前，先运行
php --ri xdebug；如果没输出，说明没加载成功，再用官网的 wizard 页面上传phpinfo()输出，它会精准告诉你该下哪个 DLL/SO 文件 - XAMPP Windows 版几乎全是 TS + VC15（PHP 7.4–8.1）或 VC17（PHP 8.2+），别选 NTS 或 VC16 的包
- 下载的 DLL 文件名里通常含
-8.1-vc15-ts这样的标识，和php -v结果逐字比对 - 放错位置也会失败：DLL 必须放进
php/ext/目录，不是apache/bin/或别的地方
重启 Apache 后仍不生效，可能是改错了 php.ini 文件
Apache 和 CLI（命令行）用的是两套 php.ini。你在命令行跑 php -m 看到 xdebug，不代表 Apache 用了同一份配置 —— 浏览器访问 http://localhost/dashboard/phpinfo.php，搜索 “Loaded Configuration File”，才是 Apache 实际加载的 ini 路径。
立即学习“PHP免费学习笔记（深入）”；
- 别只改
XAMPP/php/php.ini，那是 CLI 用的；要改XAMPP/apache/bin/php.ini或XAMPP/php/php.ini（取决于你的 XAMPP 版本，以phpinfo()显示为准） - 改完后必须通过 XAMPP 控制面板「停止 → 启动」Apache，仅重启 VS Code 或刷新页面无效
- 验证是否生效：浏览器打开
http://localhost/dashboard/phpinfo.php，Ctrl+F 搜xdebug，看到完整模块信息才算成功 - 加一行
xdebug.log="E:/XAMPP/php/logs/xdebug.log"，目录要存在且可写，出问题时第一眼就看这个日志
phpinfo() 的 Loaded Configuration File、launch.json 的 port、pathMappings 的左右路径这三点，其余都是枝节。 
