Composer安装慢的根源是Xdebug全程介入，导致性能下降3–10倍；应使用php -d zend_extension= -d xdebug.mode=off临时禁用，而非php -n或修改配置。
Composer 安装慢是因为 Xdebug 在后台全程参与
Composer 本身不慢，但 Xdebug 会强制 PHP 对每个函数调用做调试钩子注入，导致 composer install 或 composer update 的依赖解析、类加载、脚本执行阶段性能下降 3–10 倍。这不是配置问题，是 Xdebug 的设计使然 —— 它本就不该在 CLI 工具链中常驻。
临时禁用 Xdebug 最可靠的方式是命令行参数
别改 php.ini 或重启 PHP-FPM，那太重，也容易漏掉其他终端会话。直接在运行 Composer 时绕过 Xdebug：
- Linux/macOS：用
php -d zend_extension= -d extension= composer install（清空所有扩展加载） - 更稳妥的写法是显式禁用 Xdebug：
php -d zend_extension= -d xdebug.mode=off composer install - Windows PowerShell：用
php -d "zend_extension=" -d "xdebug.mode=off" composer install（引号防解析错误） - 如果报
Cannot load Xdebug - it was already loaded，说明 Xdebug 是通过zend_extension指令加载的，必须清掉该指令，不能只关 mode
为什么不用 php -n？它会干掉太多东西
php -n 确实跳过 php.ini，但也会丢掉 openssl、curl、zlib 等 Composer 必需扩展，常见报错如：file_get_contents(): SSL operation failed 或 Could not decompress gzipped response。它“太干净”，反而不可用。
- 推荐组合：保留核心扩展，只剔除 Xdebug —— 用
-d覆盖比-n更精准 - 验证是否生效：运行
php -d zend_extension= -d xdebug.mode=off -v | grep xdebug，应无任何输出 - 某些旧版 Xdebug（如 2.x）没有
xdebug.mode，得用xdebug.remote_enable=0或xdebug.default_enable=0，但优先升级到 3.1+
自动化方案：alias 或 wrapper 脚本最省事
每次敲一长串命令很烦，加个 shell alias 就行：
alias c='php -d zend_extension= -d xdebug.mode=off $(which composer)'
之后直接 c install 或 c update 即可。注意不要 alias 成 composer，否则可能干扰 IDE 或 CI 脚本里对原始命令的检测。
- 如果用的是 Homebrew PHP，
zend_extension路径通常是/opt/homebrew/lib/php/pecl/*/xdebug.so，但用空字符串赋值比写死路径更兼容 - CI 环境（如 GitHub Actions）建议在
run步骤里显式加-d参数，别依赖全局 PHP 配置 - Mac M1 用户若遇到
dyld: Library not loaded: @rpath/libc++.1.dylib，说明 Xdebug 编译版本不匹配，此时禁用是唯一稳定解法
真正麻烦的不是怎么关，而是关完忘了开 —— Xdebug 关了，IDE 断点就失效。装完依赖后，别急着关终端，顺手跑个 php -m | grep xdebug 确认它还在，才继续调试。
