Xdebug 拖慢 Composer 是因 CLI 环境中默认启用，导致 composer install 耗时增3–4倍；验证用 php -m | grep xdebug 和 time 对比，禁用用 XDEBUG_MODE=off 或 php -d zend_extension= -d xdebug.mode=off。
怎么确认 Xdebug 正在拖慢 Composer？
别猜，直接验证：Composer 变慢八成是因为 CLI 环境里 Xdebug 悄悄开着。它不报错，但会让 composer install 多花 3–4 倍时间。
- 运行
php -m | grep -i xdebug—— 有输出就说明已加载 - 运行
php -v—— 看是否带with Xdebug v3.x字样 - 对比耗时：
time composer installvstime XDEBUG_MODE=off composer install，提速通常超 70%
临时禁用 Xdebug 的可靠写法（Xdebug 3+）
Xdebug 3 废弃了 xdebug.enable=0，用错参数等于白干。必须用语义明确、兼容性好的方式。
- 推荐命令：
XDEBUG_MODE=off composer install - 如果环境变量不生效（比如某些容器或旧 shell），改用 PHP 参数：
php -d zend_extension= -d xdebug.mode=off /usr/local/bin/composer install -
zend_extension=是清空操作，比extension=更彻底（Xdebug 是 zend 扩展） - 可加别名简化日常使用：
alias c='XDEBUG_MODE=off composer'，之后敲c install就自动加速
永久分离 CLI 和 Web 的 php.ini 配置
这是最干净的解法——Web 调试照常，CLI 工具（Composer、Artisan、phpunit）彻底轻装上阵。
- 先查 CLI 用的配置：
php --ini，看Loaded Configuration File路径（通常是/etc/php/8.2/cli/php.ini） - 编辑该文件，注释掉或删除类似
zend_extension=xdebug.so或extension=xdebug的行 - 保存后执行
php -m | grep xdebug验证无输出，再跑一次composer install确认速度恢复 - Web 端的配置（如
/etc/php/8.2/fpm/php.ini或apache2/php.ini）保持不动，不影响调试
需要调试 Composer 自定义脚本时怎么办？
真要断点进 post-install-cmd 或 pre-update-cmd，就得临时开 Xdebug，但必须精准控制范围，不能全局启用。
- 不要改系统 php.ini，而是用命令行参数显式开启：
php -dxdebug.mode=debug -dxdebug.start_with_request=yes $(which composer) install - 确保 IDE（如 PhpStorm）已开启“等待连接”，且
xdebug.client_host和client_port匹配 - 调试完立刻切回无 Xdebug 模式，否则下次
composer update又变龟速 - 注意：
--no-plugins --no-scripts会跳过自定义脚本，此时开 Xdebug 也进不去，慎用
最容易被忽略的是：很多人只关了 Apache/Nginx 的 Xdebug，却没动 CLI 的配置。结果是网页调试正常，但每天敲十次 composer install 都在默默忍受三倍延迟。
