直接换国内镜像源能解决90%的卡顿问题，但必须严格满足三个硬性条件：键名必须为单数repo.packagist、type值必须显式写composer、url末尾必须带/，任一缺失均静默回退官方源；且需执行composer clear-cache并验证config输出是否为完整json。
直接换国内镜像源能解决 90% 的 composer install 卡在 “Loading composer repositories” 的问题，但不是所有镜像都可靠——配错、选错、没清缓存，效果就等于零。
为什么composer config -g repo.packagist总不生效
这不是网络慢，是命令写错了三个硬性点，且 Composer 不报错，只静默 fallback 到官方源：
-
repo.packagist必须是单数，写成repos.packagist（多一个 s）就无效 - 命令里必须显式带
composer这个 type 值，漏掉就当没配，直接走https://packagist.org - URL 必须以
https://开头，且末尾带/；写成https://mirrors.aliyun.com/composer（少斜杠）会导致路径拼成/composerpackages.json，404 后静默降级
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或字符串 "https://packagist.org" 都说明没写进去。
项目级配置比全局更可靠，尤其在 CI 和团队协作中
全局配置（-g）看似一劳永逸，但实际落地常被绕过：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Docker 构建里没有
~/.composer/config.json，CI runner 用户和你本地用户不是同一个 - 宝塔或系统服务用的是
www用户，COMPOSER_HOME路径可能指向别处 - 项目级配置写进
composer.json的repositories字段，拉代码即生效，行为一致
安全写法是进项目根目录执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意没 -g）。它会自动向 composer.json 的 repositories 对象里追加 "packagist" 条目，不覆盖已有私有源。前提是原 repositories 是对象（{}），不是数组（[]）——后者会失败，需先手动改格式。
换镜像后仍卡住？大概率是配置被覆盖或禁用
镜像只加速元数据拉取和包下载，不解决依赖解析卡顿。如果还卡在 Loading composer repositories，不是镜像没生效，而是请求根本没发过去：
- 检查
composer.json是否存在"repositories"字段，哪怕只有一行，也会优先于全局配置 - 留意是否有
"packagist.org": false或"packagist": false这类彻底关源的写法 - 运行
composer config -g repo.packagist和composer config repo.packagist（无-g）分别看输出，确认哪一层在起作用 - 临时验证是否真走镜像：加
-vvv参数跑composer install，日志里搜Downloading，看 URL 是不是指向你配的镜像域名
阿里云、清华、腾讯镜像的实际差异在哪
三家都支持 HTTPS 和 Composer 2.9.6，但同步策略和地域适配不同：
-
https://mirrors.aliyun.com/composer/：同步延迟最低（1–3 分钟），华南华东华北基本无感，Laravel/Symfony 包更新及时；小众 GitHub 私仓偶尔滞后 1–2 小时 -
https://mirrors.tuna.tsinghua.edu.cn/composer/：教育网和北方极快，南方偶发 DNS 解析慢；对 PHP 8.4 新签名兼容性验证更严，新版本上线略晚 -
https://mirrors.cloud.tencent.com/composer/：CDN 覆盖广，南方稳定；不保留已删包——遇到Package not found可能是原包被作者下架，非镜像问题
别只信测速脚本结果。真正影响体验的是同步延迟：新发布的包在阿里云镜像里 2 分钟后就能装，清华源可能要等 15 分钟——测速再快也 Package not found。换源后务必执行 composer clear-cache，否则旧缓存还在走官方源。
