不配镜像，composer install 基本跑不通；配对阿里云镜像后90%卡顿问题消失，主因是键名必须为repo.packagist（单数）、中间type值必须为composer、url末尾必须带斜杠，三者缺一即静默回退至packagist.org。
不配镜像，composer install 基本跑不通——不是你网速慢，是 packagist.org 在国内根本连不上。配对阿里云镜像后，90% 的卡在 Loading composer repositories 或 Downloading 的问题会直接消失。
为什么 composer config -g repo.packagist 总是静默失效
这条命令不报错，但实际没生效，常见于三个硬伤：
-
repo.packagist键名必须一字不差：写成repos.packagist、repository.packagist或mirror全无效 - 中间的
composer是type值，小写，不可省略——漏掉它，Composer 就当这行配置不存在 -
URL必须以/结尾：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/"}）或至少是纯 URL 字符串；返回空、null、或仍是 https://packagist.org，说明根本没写成功。
composer.json 里有 repositories 字段，全局镜像还管用吗
完全不管用。Composer 的仓库优先级是硬编码的：项目级 composer.json > 全局 ~/.composer/config.json > 默认源。只要项目根目录的 composer.json 里定义了 "repositories" 数组（哪怕只写了 []），全局配置就会被跳过。
想临时绕过项目配置验证镜像是否可用？加 --repository-url 参数：composer update --repository-url=https://mirrors.aliyun.com/composer/。注意：composer create-project 不支持 -r 参数，CI 脚本中若要用镜像，必须先 config -g 再执行，不能靠临时参数。
团队协作或 CI 环境下，该用全局还是项目级配置
项目级更可靠。全局配置在 GitHub Actions、宝塔面板（以 www 用户运行）或同事拉代码后经常失效——因为它们读不到你本地用户的 ~/.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" 字段，key 固定为 "packagist"。
如果项目已有 "repositories": [] 数组结构，别手动覆盖——命令会合并而非覆盖；但若原先是空对象 "repositories": {}，命令能自动 merge 进去；若是空数组，则需先手动改成对象结构再运行。
换源后仍卡在 Resolving dependencies？和镜像无关
镜像只加速元数据加载和 ZIP 包下载，不参与依赖解析。卡在这里基本是 composer.json 写法或环境问题：
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，让 Composer 尝试遍历大量不兼容版本 -
require-dev里塞了太多工具链（如phpunit、phpstan），大幅增加解空间 - 用了已废弃的
fxp/composer-asset-plugin（常见于老版 Yii2），它绕过 Composer 镜像机制，直连 Bower/NPM 源
这类问题换任何镜像都无效，得收紧约束、拆分 dev 包、或升级到原生 asset 管理方案。
最常被忽略的是缓存残留：即使命令执行成功，旧缓存可能包含损坏的元数据或指向 packagist.org 的记录，务必执行 composer clear-cache；改完配置后，也建议删掉 vendor/ 和 composer.lock，再跑 composer install 确保从新源拉取。
