带宽限制会放大composer原有弱点，导致卡在downloading或反复失败；需调高http.timeout至600秒、关闭parallel下载、配置阿里云镜像并清缓存，才能稳定运行。
带宽限制本身不会让 composer install 直接报错，但会放大默认超时、并发下载、缓存损坏等原有弱点，导致卡在 Downloading 或反复失败。核心不是“提速”，而是“稳住不崩”。
卡在 Downloading 是带宽瓶颈的典型信号
当网络带宽低（如 100KB/s 以下）或被 QoS 限速时，Composer 默认的 http.timeout=60 秒根本不够下载一个中等大小的 dist 包（常见 2–5MB）。它不是连不上，是连上了但收不完就断。
- 现象：日志停在
Downloading https://mirrors.aliyun.com/composer/xxx.zip，几秒后报cURL error 28: Operation timed out - 验证方式：用
curl -o /dev/null -s -w '%{speed_download}\n' https://mirrors.aliyun.com/composer/packages.json看实际下载速度 - 注意：
process-timeout在这里基本无效——它管的是整个命令生命周期，而下载卡死是单次 HTTP 请求超时
必须调高 http.timeout，且要设对位置
http.timeout 控制每次 HTTP 请求从 DNS 查询、TLS 握手到响应头返回的总耗时，默认仅 60 秒。对低带宽环境，600 秒（10 分钟）是安全下限。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局生效（推荐）：
composer config -g http.timeout 600 - 项目级更稳妥（CI 友好）：在
composer.json的"config"段加"http.timeout": 600 - 临时调试（不污染配置）：
COMPOSER_HTTP_TIMEOUT=600 composer install - 绕过 PHP socket 限制（关键）：
php -d default_socket_timeout=600 $(which composer) install—— 否则 PHP 自身的default_socket_timeout会截断请求
禁用并行下载能显著降低带宽压力
Composer 默认启用多线程下载（parallel），在带宽受限时反而造成连接争抢、TLS 握手排队、TCP 重传激增，实际吞吐反而下降。
- 关闭并行：
composer config -g parallel false - 或临时生效：
COMPOSER_PARALLEL=false composer install - 效果：下载变成串行，每包独占带宽，成功率提升明显，尤其在 1–5MB/s 带宽区间
- 副作用：总耗时变长，但不再随机中断；若你用的是 WSL2 或 Docker，还建议同步加
--no-plugins --no-scripts减少额外开销
镜像源 + 缓存清理才是带宽受限下的可靠组合
换国内镜像不是“锦上添花”，而是把原本可能跨太平洋的 300ms RTT 降到 10ms 内，极大压缩 TLS 和 TCP 建连时间——这对低带宽+高延迟组合尤为关键。
- 正确设置阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不能少） - 验证是否真生效：
composer config -g repo.packagist必须输出完整 JSON，否则静默回退官方源 - 强制清缓存再跑：
composer clear-cache && rm -rf vendor/ composer.lock—— 带宽受限时残留的半截 zip 文件极易引发后续校验失败 - 忽略
--retries：它只对 dist 下载生效，且依赖http.timeout；没调高 timeout 前加--retries=10就是十次秒败
最容易被忽略的是：项目级 repositories 字段会完全屏蔽全局镜像配置，哪怕你 composer config -g repo.packagist 写得再对。执行 composer config repositories 确认输出为空，否则得手动删掉 composer.json 里的 "repositories" 数组。
