调试失败主因是PHP扩展未启用或配置错误，需确认CLI/Web的php.ini路径一致、xdebug.mode=debug等参数正确，IDE端口与xdebug.client_port匹配，composer install仅管理依赖不配置调试环境。
composer install 调试工具前必须确认 PHP 扩展已启用
很多情况下 composer install 看似成功，但后续调试器（如 xdebug、phpdbg）根本不起作用，根源常在 PHP 本身没加载对应扩展。不是 Composer 的问题，是环境没配好。
检查方式很简单：php -m | grep -i xdebug（Linux/macOS）或 php -m 手动找。如果没输出，Composer 再怎么装插件也没用。
- Windows 用户注意
php.ini路径：用php --ini确认，别改错文件（常见改了 Apache 的，CLI 模式却用另一个） - Xdebug 3+ 默认关闭远程调试，需手动加
xdebug.mode=debug和xdebug.client_host=127.0.0.1 - PHP 8.2+ 若用 xdebug 3.1.x，注意某些旧 IDE 配置不兼容，建议升到 3.3.x
用 composer require 安装调试相关包的实际意义有限
像 composer require --dev phpunit/phpunit 或 composer require --dev psy/psysh 这类命令，装的是「开发时用的 CLI 工具」，不是让 Xdebug 或 Zend Debugger “工作”的必要条件。它们和断点调试没有直接关系。
真正影响调试能力的，是 PHP 扩展 + IDE 配置 + 启动参数三者配合。Composer 只负责把 psysh 这类 REPL 工具拉进 vendor/bin/，你运行 ./vendor/bin/psysh 才能进入交互式调试环境——但这和在 PhpStorm 里点行号打断点是两回事。
-
composer require --dev symfony/var-dumper有用：它替换var_dump()，输出更清晰，但不提供断点能力 -
composer require --dev maximebf/debugbar适合 Laravel/PHP web 请求链路追踪，依赖浏览器插件，和 CLI 调试无关 - 不要指望
composer install自动帮你开 Xdebug：它连 php.ini 都碰不到
调试插件配置本质是 IDE 和 PHP 扩展的桥接，不是 composer.json 项
所谓“配置 debug 插件”，实际是告诉 IDE（如 PhpStorm、VS Code）：「你监听哪个端口？PHP 进程是否带了 -dxdebug.mode=debug -dxdebug.start_with_request=yes？」这些和 composer.json 里的 require-dev 没有逻辑绑定。
常见错误是以为在 composer.json 加了 "phpunit/phpunit": "^10" 就等于“已配置调试”。其实只是装了个测试框架，它自己跑的时候要不要启用 Xdebug，还得看你怎么启动它：php -dxdebug.mode=debug ./vendor/bin/phpunit 才生效。
- VS Code 中
launch.json的"port"必须和xdebug.client_port一致（默认 9003） - PhpStorm 的
Preferences > Languages & Frameworks > PHP > Debug里端口要对得上，否则连接拒绝 - Web 请求调试需额外确保
xdebug.start_with_request=trigger并在 URL 加?XDEBUG_SESSION_START=1，否则只对 CLI 有效
本地开发环境调试失败，优先查 CLI 和 Web 的 PHP 配置是否分离
这是最常被忽略的一环：你在终端跑 php -v 看到 Xdebug 已加载，但浏览器访问 phpinfo() 却没有，说明 CLI 和 Web Server（Apache/Nginx）用了不同的 php.ini。Composer 只管 CLI 下的依赖，完全不介入 Web 环境。
验证方法：php -i | grep "Loaded Configuration File" 对比 phpinfo() 页面里显示的路径。两者不同，就必然一个能调试、一个不能。
- Docker 环境下，
docker exec -it app php -m和宿主机php -m是两套环境，别混着查 - MAMP/XAMPP 用户：默认 Web 模式禁用 Xdebug，需手动编辑其自带的
php.ini并重启服务 - 使用
php -S内置服务器时，它走 CLI 配置，所以php -S localhost:8000 -t public能用 Xdebug，但 Nginx 不一定
