直接结论：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 必须严格满足四个条件才生效——带 -g、键名是 repo.packagist（单数）、type 值显式写 composer、URL 为 HTTPS 且末尾有斜杠；否则静默失败。
直接结论：用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这条命令就能生效，但漏掉任意一个细节——比如少个 s、缺斜杠、没写 composer 类型值——它就静默失败，不报错也不提示，你根本不知道没配上。
为什么 composer config -g 命令总像没反应？
常见现象是执行完再查 composer config -g repo.packagist，输出为空或仍是 https://packagist.org。这不是网络问题，而是命令本身写错了三个硬性条件：
-
-g不能省：缺了就只改当前项目，换目录就失效 -
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） -
composer是必须显式写的type值，不是可选参数；省略后 Composer 2.0+ 会 fallback 到官方源 - URL 必须是 HTTPS，且末尾
/不能少（少斜杠会导致拼出/composerpackages.json而 404）
项目级配置比全局更可靠，尤其适合 Git 和 CI
全局配置无法被 Git 跟踪，CI 流水线常以 runner 或 www 用户运行，跟你本地 $USER 的 ~/.composer/config.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"字段，key 固定为"packagist"，不会覆盖已有私有源 - 前提是原
"repositories"是对象结构（如{}），不是数组（如[]）；如果是数组，命令会报错，得先手动改成对象 - 改完别忘了删掉
vendor/和composer.lock，再跑composer install
换源后还卡在 “Resolving dependencies”？和镜像没关系
镜像只加速元数据拉取和 ZIP 下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，大概率是以下原因：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，让 Composer 需要尝试大量组合 -
require-dev里塞了太多未锁定的开发工具（比如phpunit/phpunit不带版本号） - 用了已废弃的
fxp/composer-asset-plugin，它额外请求 Bower/NPM 源，而这些源没国内镜像
验证是否真生效，别信 composer diagnose
composer diagnose 显示 “OK” 只说明配置语法对、本地网络通，**完全不验证镜像元数据是否完整、是否支持 Composer 2.9.6 协议**。真正有效的验证方式只有两个：
- 全局：运行
composer config -g repo.packagist，输出必须是类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 项目级：运行
composer config repo.packagist，看是否返回对应 URL；或者直接composer install -vvv，观察日志里出现的GET https://mirrors.aliyun.com/composer/...
最常被忽略的一点：改了镜像源之后，composer.lock 里的包哈希是按旧源生成的，不清理它，新镜像可能因元数据微小差异导致校验失败或跳过更新。删锁文件和 vendor 再重装，才是干净起点。
