结论：全局配置composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/最快上手，但90%失效源于三硬伤——键名必须为单数repo.packagist（非repos）、composer为必填type值、URL末尾必须带/；项目级配置更可靠，因全局配置易被composer.json中repositories字段屏蔽，且CI/容器环境常因用户权限或路径问题读取失败。
直接说结论：全局配置 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 是最快上手方案，但 90% 的失败不是网络问题，而是命令漏了三个硬性条件——repo.packagist（不能多 s）、composer（type 值不可省）、URL 末尾必须带 /。
为什么 composer install 卡在 “Loading composer repositories”
这不是你宽带慢，是 Composer 默认从 https://packagist.org 拉元数据（packages.json），这个过程要 TLS 握手 + CDN 解析 + 全量同步，国内直连常超时或返回 503。镜像源同时替换元数据接口和 ZIP 分发节点，二者不匹配会报 Package not found 或 Signature mismatch。
- 清华、阿里、腾讯镜像同步延迟通常 ≤5 分钟，稳定性高
- 华为云镜像适合企业级项目，对私有包兼容更好
-
https://packagist.laravel-china.org仅适配 Laravel 生态，非 Laravel 项目慎用
composer config -g repo.packagist 静默失效的三大原因
这条命令不报错，但写不进配置就等于没配。验证方式只有一条：composer config -g repo.packagist 输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报 Key 不存在，说明失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repos.packagist（多一个 s）→ 完全无效，Composer 忽略 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/（漏掉中间composer）→ fallback 到官方源 -
https://mirrors.aliyun.com/composer（末尾缺/）→ 拼出/composerpackages.json导致 404
项目级配置才是团队协作和 CI 的真实解法
全局配置在宝塔、GitHub Actions、Docker 容器里基本不可靠——它们运行用户不是你本地登录用户，读不到 ~/.composer/config.json。项目级配置写进 composer.json，所有人拉代码后行为一致。
- 进项目根目录执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令自动合并到
"repositories"字段，不会覆盖已有私有源 - 如果项目已存在
"repositories": []数组，它会追加新对象；如果是{}，会转为标准结构 - 改完必须删掉
vendor/和composer.lock，再跑composer install，否则旧 lock 文件仍指向海外源
换源后还卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载，不解决依赖解析慢的问题。如果你发现 composer update 卡几十秒甚至几分钟，根源在 composer.json 写法或本地环境：
-
"php": "^7.4 || ^8.0"这类宽泛约束会让 Composer 尝试大量版本组合 -
require-dev里塞了太多未锁定的工具包（如"phpunit/phpunit": "^10.0"） - 用了已废弃的
fxp/composer-asset-plugin（常见于老 Yii2 项目），它绕过 Composer 镜像，直连 Bower/NPM 源
真正容易被忽略的是：镜像源本身不参与依赖解析逻辑，只负责“找到包后快速下载”。解析慢，得查 composer.json 的约束写法、PHP 版本、以及是否混用了不兼容的插件。
