Composer install卡在Updating dependencies本质是本地SAT求解器穷举版本组合，非网络问题；应收紧版本约束、设minimum-stability为stable、禁用Xdebug、清缓存并用--prefer-dist加速。
composer install 时卡在 Updating dependencies 怎么办
这一步根本没走网络，纯粹是本地求解器在穷举满足所有约束的版本组合。镜像源、换 CDN、清缓存——全都没用。真正拖慢它的，是你 composer.json 里那些宽泛得离谱的约束。
常见致慢写法：
-
"php": "^7.4 || ^8.0"：让求解器同时考虑两个大版本生态，依赖图爆炸式增长 -
"minimum-stability": "dev"：强制拉取所有dev-分支元数据，数量可能是 stable 版本的 5–10 倍 -
"monolog/monolog": "*"或"^1.0 || ^2.0"：模糊范围越大，可选版本越多，回溯搜索越深
实操建议：
- 删掉
minimum-stability，或显式设为"stable" - 把
*和||替换成具体小版本，比如"^2.10.0" - 执行
composer update --with-dependencies观察耗时变化，确认是否收敛
导出依赖时加 --prefer-dist 能快多少
它不导出 Git 仓库，而是直接下载预编译好的 .zip 包。对含大量 PHP 文件但无构建步骤的包（如 symfony/console），速度提升明显；但对需要 post-install-cmd 编译的包（如 ext-xxx 扩展绑定项目），可能跳过必要步骤。
推荐组合：
-
composer install --prefer-dist：适合绝大多数纯 PHP 项目 -
composer install --prefer-dist --no-dev：CI/CD 部署必备，跳过测试/调试类依赖 - 慎用
--prefer-source：仅在需 patch 某个包、或调试 Git 提交历史时才启用
注意：--prefer-dist 对首次 install 加速显著，但对已有 vendor 的 update 影响有限。
为什么 clear-cache 是导出前必做动作
缓存里存着旧的 packages.json 和元数据，Composer 会优先读缓存，哪怕你刚配好阿里云镜像，它仍试图从旧地址拉校验信息——结果卡在 DNS 解析或 TLS 握手，日志里却看不到镜像域名。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须执行：
-
composer clear-cache：强制刷新元数据通道 -
rm -rf vendor composer.lock：避免install时因 hash mismatch 报错 - 再跑
composer install --prefer-dist --no-dev
CI 环境中尤其要注意：如果用 www 用户运行命令，clear-cache 也得用对应用户执行，否则缓存清理无效。
PHP 运行环境本身就在拖慢导出
Xdebug 是最常被忽略的性能杀手。它会让 Composer 的依赖解析和自动加载器生成慢 3–5 倍，尤其在 Updating dependencies 阶段 CPU 占满却无进度时，大概率是它在后台做代码路径追踪。
验证方式：
- 执行
php -v，看输出是否含xdebug - 执行
php -m | grep xdebug
临时禁用方法：
php -d xdebug.mode=off composer install- 或在 CI 脚本开头加
php -d zend_extension= -d xdebug.mode=off composer ...
别指望只关掉 IDE 功能就完事——Xdebug 2.x 默认全开，3.x 虽默认 mode=off，但很多 Docker 镜像或一键环境仍手动启用了它。
