Composer install卡在Downloading阶段本质是并发池触发镜像QPS限流，需同时配置多镜像（国内源设"canonical": false）、降并发至2（composer config -g repos.packagist.org.concurrent-downloads 2）、清缓存；缺一不可。
composer install卡在Downloading阶段，本质是并发池被镜像QPS限流打爆
不是带宽不够，也不是机器慢，而是 Composer 默认并发池（http-max-concurrent-downloads）设为 6–10 时，瞬间触发国内主流镜像（阿里云、腾讯云、清华）的单IP QPS硬限制（通常 60 次/分钟）。日志里反复出现 curl: (28) Operation timed out 或静默卡住几秒后跳下一个包，就是典型信号。
关键点在于：Composer 下载阶段是真并发，但依赖解析仍是串行；一旦某个包因限流超时（默认 300 秒），整个并发池会被阻塞等待——“一个包拖垮全链路”。
- 必须同时做三件事：配多镜像（含
"canonical": false）、降并发至2、清缓存；缺一不可 - 只换一个镜像源（比如只切阿里云）在 CI 场景下极易失效，因为构建节点集中打同一地址，秒级触发限流
-
composer config -g repos.packagist.org.concurrent-downloads 2是唯一有效降级方式（注意不是http-max-concurrent-downloads，那是全局高并发用的）
多镜像负载均衡必须带 "canonical": false 才生效
Composer 原生支持多镜像 fallback，但默认只认第一个；后面镜像形同虚设，除非显式声明 "canonical": false。否则 composer install -vvv 日志里永远只看到一个域名在下载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确配置示例（写入项目 composer.json 的 repositories）：
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/",
"canonical": false
},
{
"type": "composer",
"url": "https://mirrors.tuna.tsinghua.edu.cn/composer/",
"canonical": false
},
{
"type": "composer",
"url": "https://packagist.org",
"canonical": true
}
]
}
-
"canonical": true只能出现在最后一个兜底源（通常是 packagist.org），表示它是权威元数据源 - 所有国内镜像都必须加
"canonical": false，否则 Composer 不会轮询或 fallback - URL 结尾必须有
/，否则拼接packages.json路径时 404
CI/CD 中必须关闭 --no-dev/--no-scripts/--no-autoloader 的干扰
这些参数在开发环境有用，但在构建阶段会显著拖慢海量小包场景：它们不减少下载量，反而让 Composer 在单线程里多做一轮判断和清理，尤其 --no-autoloader 会导致后续 dump-autoload 阶段无法利用 classmap 缓存。
-
--no-dev：跳过require-dev包，避免测试类污染 autoload classmap（但不影响下载并发） -
--no-scripts：禁用post-install-cmd等钩子，防止 npm install 或 DB 清理等重型操作阻塞主线程 -
--no-autoloader：不生成vendor/autoload.php，后续用composer dump-autoload --optimize --classmap-authoritative单独补，避免安装时同步扫描 PSR-4 目录 - 漏掉任意一个，
composer install都可能多花 30%–60% 时间——不是错觉，-vvv日志里能看到大量Generating autoload files和Executing command占满单核
extract 阶段卡住？那是磁盘 I/O 瓶颈，不是网络问题
当 Downloading 很快但卡在 Extracting archive，说明并发下载已完成，瓶颈已转移到文件系统：Composer 解压 ZIP 时密集调用 file_put_contents、mkdir、stat，在 macOS APFS、Windows NTFS 或 CI 挂载卷上延迟被放大。
- CI 中禁用
vendor/目录挂载（如-v $(pwd)/vendor:/app/vendor），改用容器内生成 +rsync -av --delete导出 - 把
cache-dir迁移到 SSD 或 tmpfs：sudo mount -t tmpfs -o size=2G tmpfs /mnt/ramdisk，再composer config -g cache-dir /mnt/ramdisk/composer-cache - 禁用 ZIP 缓存减小写压力：
composer config --global cache-files-maxsize 0 -
--no-autoloader --no-scripts必须配合使用，否则 autoload 生成和脚本执行仍会在 extract 后串行阻塞
