Composer镜像配置必须同时满足三个硬性条件才生效：键名严格为单数repo.packagist、type值显式写composer、URL以HTTPS开头且末尾带/，任一缺失即静默回退官方源；验证需执行composer config -g repo.packagist并输出完整JSON。
配镜像不是“提速技巧”，是依赖能装起来的前提——不配，composer install 卡在 Downloading 阶段基本等于失败。
composer config -g repo.packagist 为什么总不生效
它不报错，但就是不走镜像，90% 是因为三个硬性条件漏掉一个：
-
repo.packagist不能写成repos.packagist（多一个s就静默忽略） - 中间那个
composer是type值，必须显式写出，漏掉就 fallback 到官方源 -
url必须以https://开头，且末尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
验证方式只有一条：composer config -g repo.packagist。输出必须是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是 https://packagist.org，说明根本没写进去。
项目级配置怎么安全追加镜像而不破坏私有源
全局配置在 CI、宝塔、Docker 里大概率读不到，项目级更可靠。进项目根目录后执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动处理三种情况：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果
composer.json原本是"repositories": {}，它会转为标准数组并插入 packagist 条目 - 如果原本是
"repositories": []，它会向数组末尾追加，不覆盖已有 Git/VCS 源 - 如果根本没有
repositories字段，它会新建，且 key 固定为"packagist"（不能自定义）
千万别手动写 "packagist": false——这会导致 ext-json 等基础扩展校验失败。
换镜像后 still 卡在 Downloading？你可能没清缓存
镜像只代理元数据（包名、版本、依赖关系），不托管 zip 包。旧 composer.lock 里记录的 dist.url 还是 GitHub 地址，比如 https://codeload.github.com/...，换源后照样走原始链接。
必须做两件事才能真正生效：
- 删掉
vendor/和composer.lock - 再跑
composer install（不是update）
CI 脚本里还要加 --no-cache -vvv：前者防止复用旧缓存，后者从日志里确认是否真在请求 mirrors.aliyun.com。
最常被忽略的点：镜像不加速 Resolving dependencies 阶段，只管下载。如果卡在这一步，该收紧 require 版本约束，而不是换镜像。
