正确命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，三要素缺一不可：键名必须为repo.packagist（单数）、中间composer为必需type值、url须以https开头且末尾带斜杠；验证需同时满足config输出完整json、diagnose显示阿里云地址、-vvv日志含mirrors.aliyun.com。
composer config -g repo.packagist 命令必须三要素齐全
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但漏掉任意一个细节都会静默回退到 packagist.org，且不报错、不提示。
这三要素是：
-
repo.packagist是固定键名，写成repos.packagist（多 s）或packagist.org都无效 - 中间的
composer是 type 值，不能省略，也不能替换成https或空字符串 - URL 必须是 HTTPS，且末尾必须带斜杠：
https://mirrors.aliyun.com/composer/✅，少斜杠会请求/composerpackages.json导致 404
验证镜像是否真生效，只看三个输出
别信“执行完就 OK”，必须同时满足以下三点才算成功：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON，例如：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；如果返回空、null或Key "repo.packagist" does not exist，说明根本没写进去 - 运行
composer diagnose，检查 “Repo” 行是否显示阿里云地址；若仍是https://packagist.org，大概率被项目级repositories覆盖了 - 运行
composer install -vvv 2>&1 | grep "Downloading"，日志中出现的域名必须是mirrors.aliyun.com——这是最终确认依据
项目级配置会覆盖全局，且行为更敏感
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g），它会向 composer.json 的 repositories 字段写入 "packagist": {"type": "composer", "url": "..."} 。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
但要注意：
- 如果
composer.json原来是"repositories": []（数组格式），该命令会直接报错；需先手动改成"repositories": {}（对象）再重试 - 只要
composer.json里存在"repositories"字段（哪怕内容为空或仅含"packagist.org": false），全局配置就完全失效 - 配完必须删掉
vendor/和composer.lock，再跑composer install；用update会复用旧 lock 文件，仍可能走原始源
换源后卡在 Resolving dependencies 不是镜像问题
镜像只加速下载环节，完全不参与依赖解析。卡在这里和镜像无关，典型原因有：
-
composer.json里写了太宽泛的 PHP 版本约束，比如"php": "^7.4 || ^8.0 || ^8.1"，导致 Composer 尝试大量组合 - 某些扩展约束（如
ext-gd、ext-mbstring）与当前环境不匹配，触发反复回溯 - 项目级
repositories字段里混用了私有源 + 阿里云镜像，但结构不合法（比如"packagist": {}没包在对象里）
这种情况下，即使镜像配置完全正确，也看不出任何加速效果——因为压根还没走到下载那步。
