composer全局镜像配置不生效，根本原因是repo.packagist键名必须为单数、composer为必填type值、url须https且末尾带斜杠，三者缺一不可；验证需composer config -g repo.packagist返回完整json，否则未写入。
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这条命令就能生效，但写错任意一个字符（比如漏 -g、少末尾斜杠、键名写成 repos.packagist）都会静默失效——不是慢，是根本没走镜像。
为什么 composer config -g repo.packagist 总不生效？
它不报错，但请求日志里全是 packagist.org，90% 是因为三个硬性条件缺一不可：
-
repo.packagist必须是单数，不能写成repos.packagist或packagist.org；Composer 2.x（当前主流）只认这个 key，错写就当没这回事 - 中间的
composer是 type 值，不是注释或可选参数——漏掉它，Composer 会直接 fallback 到官方源 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出/p2//packages.json，404）
验证是否真写进去了，只看这一行输出：composer config -g repo.packagist。必须返回类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON；空、null、报 Key not found，都说明失败。
项目级配置比全局更可靠
CI/CD、宝塔、Docker 容器里常以 www 或 runner 用户运行，根本读不到你本地 root 或个人账户下的全局配置。项目级配置写进 composer.json，Git 可追踪，行为可预期：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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） - 该命令会自动识别已有
"repositories"结构：如果是对象，就写入"packagist"键；如果是数组，就追加新项，不破坏私有源 - 改完立刻跑：
composer update --lock，确保composer.lock记录的是镜像源地址，而非官方源 - 千万别手动写
"packagist": false——这会让php、ext-json等基础约束校验失败
换镜像后还卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载环节（Downloading、Fetching package），不参与依赖解析。如果卡在 Resolving dependencies 超过 10 秒，问题大概率出在本地：
-
composer.json中 PHP 版本约束太宽，比如"php": "^7.4 || ^8.0 || ^8.1"，让求解器暴力尝试大量组合 - 存在未锁定的
dev-分支依赖，如"monolog/monolog": "dev-main" -
require-dev里塞了太多工具包，尤其是已废弃的fxp/composer-asset-plugin -
composer.lock被删或没提交，导致install实际退化为update
真正该验证的，是 -vvv 日志里出现的 URL 域名——只有看到 GET https://mirrors.aliyun.com/composer/p2/ 才算真生效；其他都是假快。
