根本原因是Composer 2.x对配置硬校验，必须同时满足：键名严格为repo.packagist（单数）、type值显式写composer、URL为HTTPS且末尾带/，缺一则静默回退官方源。
composer config -g repo.packagist 命令为什么总不生效
根本原因不是网络卡，而是 Composer 2.x 对配置项做硬校验，漏掉任意一个细节就静默 fallback 到 packagist.org，且不报错、不提示。
必须同时满足这三点：
-
repo.packagist键名必须是单数 —— 写成repos.packagist或packagist.org都无效 - 中间的
composer是 type 值，不能省略，也不能替换成https或其他字符串 - URL 必须是 HTTPS，且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会请求/composerpackages.json导致 404）
还要加 -g，否则只改当前项目 composer.json，换目录就失效。
怎么确认镜像真的在用
别信“执行完就 OK”，必须验证输出。最可靠方式是查全局配置值：
运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}
如果返回空、null、Key "repo.packagist" does not exist，说明没写成功。
辅助验证：加 -vvv 运行 composer install -vvv 2>&1 | grep "Downloading"，日志里出现的域名必须是 mirrors.aliyun.com 或你配的镜像域名。
项目级配置比全局更可靠
你在终端配好了全局镜像，但宝塔后台、GitHub Actions、Docker 容器里照样连不上——因为它们用的是不同用户的 ~/.composer/config.json。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
进项目根目录（含 composer.json），运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
它会自动向 composer.json 的 repositories 字段写入 "packagist": {"type": "composer", "url": ""}。
注意：
- 如果
repositories已是数组格式（[]），命令会报错；需先手动改成对象{} - 改完必须删掉
vendor/和composer.lock，再运行composer install——update会复用旧 lock 文件，可能仍指向海外源
换源后还卡在 Resolving dependencies 怎么办
镜像只加速元数据下载，完全不参与依赖解析。卡在这里和镜像无关。
典型原因：
-
composer.json里写了太宽泛的 PHP 版本约束，比如"php": "^7.4 || ^8.0 || ^8.1"，导致 Composer 尝试大量组合 - 本地缓存或
composer.lock里仍存着旧地址，哪怕刚配好镜像，它也可能还在往packagist.org发请求
必须清缓存：composer clear-cache，并确保删了 vendor/ 和 composer.lock 后重装。
真正容易被忽略的是：镜像同步有延迟（阿里云通常 5–10 分钟），如果刚切源就跑 install，可能拉到的是旧元数据；遇到 Could not find package，先等几分钟再试，或换腾讯云镜像（https://mirrors.cloud.tencent.com/composer/）同步更快。
