镜像配置错误导致超时的主因是键名、type、URL格式三者不合规：repo.packagist必须单数，type值“composer”不可省略，URL须以https://开头且末尾带斜杠；同时需清理缓存、检查项目级配置、验证流量是否走镜像，并调整timeout等参数。
镜像配置写错就等于没配
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后仍超时，大概率是命令本身写错了。Composer 2.0+ 对键名、type、URL 格式三者都有硬性要求，缺一就会静默 fallback 到官方源。
-
repo.packagist必须是单数，写成repos.packagist（多一个 s）或repositories.packagist.org都无效 - 中间的
composer是 type 值，不能省略；漏掉它，composer diagnose会报Repo is not configured properly - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会导致请求路径拼成/composer/packages.json直接 404） - 验证是否真生效：运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、或仍是https://packagist.org都说明没写进去
缓存不清理，镜像再快也白搭
Composer 会缓存元数据（packages.json、provider-*.json 等），即使你改了镜像配置，旧缓存仍可能触发对 packagist.org 的失败请求——这不是网络问题，是状态污染。
- 必须先清缓存：
composer clear-cache - 手动删掉本地仓库缓存目录：
rm -rf ~/.composer/cache/repo/https---packagist.org/（Linux/macOS）或%APPDATA%\Composer\Cache\repo\https---packagist.org\（Windows） - 项目级
composer.json中若存在"repositories"字段，它会覆盖全局配置；检查并删除或改成阿里云地址，尤其警惕残留的laravel-china.org或已下线域名 - 验证流量是否真实走镜像：
composer install -vvv | grep -i "mirrors.aliyun"，没输出就说明还在直连海外
下载中断后残留文件会让后续安装反复失败
Composer 没有断点续传能力。中断后留下的损坏 ZIP、截断的 installed.json 或校验失败的包，会让后续所有 install 或 update 循环报错，不是重试能解决的。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 出现
Failed to extract vendor/package-name: unable to open archive→ 缓存 ZIP 已损坏 -
Invalid argument supplied for foreach()→vendor/composer/installed.json被截断或为空 -
Content-Length mismatch→ 下载不完整，缓存复用导致校验失败 - 进度条卡在同一个百分比超过 2 分钟，且
-vvv显示刚下载完就报错 → 必须清理 - 此时必须按顺序执行：
rm -rf vendor（Linux/macOS）或rmdir /s vendor（Windows），再composer clear-cache，最后composer install --no-plugins --no-scripts --prefer-dist
超时参数和下载模式要同步调
镜像解决的是“慢”，timeout 解决的是“断”。腾讯云/阿里云镜像首字节响应偶尔延迟高，仅调一个参数没用。
-
http.timeout控制 DNS、TLS 握手、body 下载全过程，默认 60 秒不够用：composer config -g http.timeout 600 -
process-timeout控制整个命令生命周期（含解压、脚本执行），大项目很容易超：composer config -g process-timeout 1200 -
--prefer-dist强制走 ZIP 包，体积小、校验快、失败率低；"prefer-source": true会让镜像完全失效（镜像不代理 Git 克隆） - CI/CD 环境更需注意：
COMPOSER_HOME未固化会导致配置丢失，构建脚本开头必须显式执行上述config命令
真正卡住的地方往往不在网络，而在缓存残留、配置拼写、参数组合这三处。动手前先 composer config -g -l 和 composer config -l 对比着看，比反复重试快得多。
