composer镜像配置必须同时满足三个硬性条件：键名严格为单数repo.packagist、第二个参数必须显式写composer（type值）、url须https且以/结尾，缺一即静默回退官方源；验证需执行composer config -g repo.packagist并确认输出为完整json对象。
配镜像源不是“试试看”，不满足三个硬性条件就等于没配——composer install 依然会卡在 Loading composer repositories，且不报错、不提示。
为什么 composer config -g repo.packagist 总是静默失败
90% 的失败源于命令写错三处，Composer 2.x 会直接 fallback 到 https://packagist.org，不报错也不警告：
-
repo.packagist必须是单数，写成repos.packagist、packagist.org或repository.packagist都无效 - 中间的
composer是type值，不是注释或可选参数，漏掉即配置被忽略 - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会请求/composerpackages.json导致 404）
怎么验证镜像是否真生效
别信“命令没报错”，只看这一条输出：
运行 composer config -g repo.packagist，正确结果必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果返回空、null、Key "repo.packagist" does not exist，或仍是 https://packagist.org，说明根本没写进去。
进一步确认可加日志：运行 composer install -vvv 2>&1 | grep "Reading packages.json"，日志中出现的域名必须是 mirrors.aliyun.com，而非 packagist.org。
项目级配置为什么比全局更可靠
全局配置（加 -g）只对当前 shell 用户生效。宝塔后台用 www 用户、GitHub Actions 用 runner 用户、Docker 容器默认非 root 用户——它们都读不到你本地的 ~/.composer/config.json。
进项目根目录（确保有 composer.json），执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加 -g）
这条命令会自动向 composer.json 的 repositories 字段安全追加，前提是原字段为对象格式（{}）；若已是数组（[]），会报错，需先手动改为对象。
改完必须删掉 vendor/ 和 composer.lock，再运行 composer install（不是 update），否则旧 lock 文件仍指向海外源。
composer create-project 换源也没用？这是设计使然
该命令默认绕过所有镜像配置，直接访问 packagist.org 下载 skeleton 包，--repository-url 参数也无效（它不支持 -r）。
正确做法是显式指定镜像地址：
composer create-project laravel/laravel myapp --repository-url=https://mirrors.aliyun.com/composer/
注意：某些 starter 模板（如 Symfony）还会额外克隆 Git 仓库，镜像只加速包下载，Git 部分仍需代理或换 fork。
最常被忽略的一点：换源后首次 install 报 hash 校验失败，不是镜像问题，而是旧 composer.lock 里记录的是海外源的 dist URL —— 必须删干净再重装，没有捷径。
