Composer安装必须配置composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，因2.2+版本元数据请求硬编码绕过repositories列表；配错键名、缺type值或URL末尾无斜杠均导致静默失效，且镜像同步滞后可能引发provider-*.json 404。
Composer安装包管理本身不依赖镜像同步，但包下载和元数据解析必须走正确配置的镜像源——配错或漏配，哪怕用的是阿里云地址，照样卡在 provider-*.json 请求上。
composer config -g repo.packagist 是唯一生效入口
很多人往 composer.json 的 repositories 数组里加了阿里云地址，结果 composer install 还是慢、还是报 Could not fetch packages.json。这不是网络问题，是 Composer 2.2+ 之后的硬编码行为：所有官方包的元数据（packages.json、provider-laravel~10.0.json 等）默认绕过 repositories 列表，直连 packagist.org。
真正起效的只有这一条命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
它会覆盖 Composer 内部的元数据源路由逻辑。其他写法全无效：
-
repos.packagist或repositories.packagist→ 键名拼错，静默失效 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 缺composertype 值，Composer fallback 到官方源 -
https://mirrors.aliyun.com/composer（末尾没/）→ 请求路径变成/composerpackages.json，404 - 用 HTTP 地址 → Composer 2.x 默认拒绝，报
Invalid repository type
项目级配置要删 vendor + lock 才能生效
团队协作或 CI/CD 场景下，全局配置不可靠（不同用户、不同 runner 账户读取不同家目录），推荐项目级配置：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会把镜像写进当前项目的 composer.json 的 repositories 字段，但有前提：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 原
composer.json中repositories必须是对象（如"repositories": { "packagist": {} }），不是数组；否则命令失败 - 改完后必须手动删掉
vendor/和composer.lock，再跑composer install - 如果只跑
composer update，composer.lock里仍存着旧的 dist URL，Composer 完全不查新配置
验证是否生效：运行 composer config repo.packagist，输出应为 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；或 composer show packagist/support，URL 应含 mirrors.aliyun.com。
镜像同步滞后导致 404，得换源或等
composer diagnose 报 Could not fetch packages.json，别急着调网络或重装，先确认是不是镜像同步没跟上：
- 用
curl -I https://mirrors.aliyun.com/composer/p2/laravel/framework/10.0.0.json测镜像是否返回 200 - 再比对官方源：
curl -I https://repo.packagist.org/p2/laravel/framework/10.0.0.json - 如果官方有、镜像无，说明该镜像暂未同步（阿里云通常 15 分钟一次，中科大源有时更及时）
- 临时切源：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/
注意：-vvv 日志里 “Resolving dependencies” 那行只是开始，真正卡点在后续几百次 provider 请求——别被那行日志骗了。
并发下载数太低，带宽压不满
Composer 2.2+ 默认并发下载数是 5，对国内多节点镜像来说太保守。实测调到 15 才能压满带宽：
composer config -g process-timeout 300<br>composer config -g use-include-path true<br>composer config -g preferred-install dist<br>composer config -g github-protocols ["https"]<br>composer config -g max-workers 15
其中 max-workers 控制并行下载线程数。设为 15 后，中型项目安装时间可从 2 分钟再压缩 30% 左右。但别盲目调更高——超过 20 容易触发镜像站限流，反而变慢。
