Composer镜像配置失效最常见原因是键名写错（如repos.packagist）、漏掉type值composer、URL末尾缺/，三者缺一即静默回退官方源；且必须清缓存、调高超时参数并确保证书可信，否则仍卡在Downloading。
镜像配置写错了，或者写了但没清缓存，是切换失败最常见原因；超时本质是 process-timeout 太短 + 源没切成功双重作用，不是网络差。
composer config -g repo.packagist 命令为什么没生效
这条命令看似执行成功，实际常静默失败。关键点全在参数拼写和结构上：
-
repo.packagist不能写成repos.packagist（多一个s就被忽略） - 必须带
composer类型参数：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间的composer会当成 URL 直接写入，后续解析失败 -
https://mirrors.aliyun.com/composer/结尾的/不能省，少写会导致 404 或版本约束解析错误 - 没加
-g参数 → 只改当前目录下的composer.json，换项目就失效
验证是否真正生效：运行 composer config -g repo.packagist。输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果为空、为 null，或仍显示 https://packagist.org，说明根本没写进去。
换了镜像还是卡在 Downloading，必须立刻清缓存
Composer 优先读本地缓存里的元数据，哪怕镜像已切对，缓存里还存着旧源的 packages.json 和 provider 文件，它仍会尝试连 packagist.org 做校验 —— 这一步就卡在 DNS 或 TLS 握手，报错却只显示 file could not be downloaded。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer clear-cache强制清空所有缓存 - 已有
vendor/和composer.lock的项目，建议一并删除再跑composer install，避免残留干扰 - 验证是否真走镜像：用
composer show laravel/framework -vvv 2>&1 | grep "Downloading"，日志里必须出现mirrors.aliyun.com或你设的镜像域名
process-timeout 和 http-basic-timeout 必须一起调高
process-timeout 控制整个命令生命周期（含 git clone、解压），默认仅 300 秒；http-basic-timeout 控制单次 HTTP 请求连接/读取， 默认 60 秒。只改一个，另一层仍会中断。
- 全局永久生效：
composer config -g process-timeout 1800+composer config -g http-basic-timeout 300 - 临时调试可用：
composer install --timeout=1200 --http-basic-timeout=240（注意--http-basic-timeout仅 Composer 2.2+ 支持） - 值设为
0表示不限时，不建议，可能卡死无响应
注意：composer.json 里的 config.timeout 不影响下载流程，它只控制某些插件行为，别在这儿浪费时间。
镜像站 HTTPS 握手失败怎么办
阿里云、华为云镜像使用 GlobalSign 等主流 CA 签发证书，但老旧系统（如 CentOS 6、某些 Jenkins slave 镜像、Docker 官方 PHP 基础镜像）根证书库过期，curl 或 Composer 会直接报 SSL certificate problem。
- 先手动测试：
curl -I https://mirrors.aliyun.com/composer/packages.json，看是否返回200 - 若报 SSL 错误，升级系统 CA 证书包：
sudo update-ca-certificates（Debian/Ubuntu）或sudo yum update ca-certificates（CentOS/RHEL） - CI 或可信内网环境可临时禁用证书校验：
composer config -g secure-http false，但不要在生产环境用
复杂点在于：镜像配置、缓存清理、超时参数、证书信任这四者必须全部到位，缺一不可。最容易被跳过的，就是清缓存那一步 —— 写完 config 就跑 install，结果还在原地等 packagist.org 超时。
