执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 可切换至阿里云镜像，但需严格满足键名、type 值和 url 格式三条件，否则静默失效；composer 2.1+ 才支持并发与新版协议，升级后须清缓存并移除 prestissimo 插件。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能切到当前最稳最快的中文镜像，但漏掉 -g、写错键名、URL 缺末尾 / 或漏掉中间的 composer type 值，都会静默失效——命令不报错，但 composer install 仍直连 packagist.org。
确认 Composer 版本和基础环境
Composer 2.1+ 才支持并发下载和新版镜像协议，低于这个版本（比如 2.0.x）即使配对镜像也跑不快。运行 composer --version，输出应类似 Composer version 2.7.6。若版本偏低：
- 先升级：
composer self-update --prefer-dist - 升级后必须立刻清缓存：
composer clear-cache，否则旧元数据会干扰新逻辑 - 检查是否残留插件：
composer global remove hirak/prestissimo（该插件与 2.1+ 内置并发冲突）
执行正确命令切换阿里云镜像（推荐首选）
截至 2026 年 7 月，阿里云镜像同步最快（多数新包 5 分钟内入库）、CDN 覆盖全、HTTPS 稳定，且支持内网加速（ECS 用户可用 http://mirrors.cloud.aliyuncs.com/composer/）。执行命令时必须严格满足三项条件：
- 键名是
repo.packagist（单数、全小写、不能写成repos.packagist或packagist.org） - 中间的
composer是必需的type值，不是注释，漏掉就 fallback 到官方源 - URL 必须以
https://开头，且末尾带/：例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径会变成/composerpackages.json导致 404）
完整命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证镜像是否真在生效
别信“好像快了”，要查真实配置和网络行为：
- 运行
composer config -g repo.packagist，正确输出必须是完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果为空、null或报Key not found，说明没写进去 - 执行
composer diagnose，看 “Repo” 行是否显示你的镜像地址；若仍是https://packagist.org，大概率被项目级repositories字段覆盖了 - 删掉
vendor和composer.lock，再跑composer install -vvv，观察日志里下载 URL 是否含mirrors.aliyun.com
遇到问题优先排查这三处
换源后仍卡住或拉不到包，90% 不是镜像挂了，而是本地配置被覆盖或缓存未清：
-
composer.json里有"repositories"字段？它会完全屏蔽全局配置；临时解决：删掉该字段，或改用composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）安全合并 -
composer.lock里的dist.url还指向原始源？哪怕镜像已生效，composer install仍会先试旧地址；必须删 lock 文件重装 - 缓存目录里元数据过期？运行
ls -lh $(composer config --global cache-dir)/repo/https---mirrors.aliyun.com-composer/packages.json，若修改时间 > 15 分钟，说明 Composer 在用旧数据算依赖
真正容易被忽略的是：镜像只加速元数据加载和 ZIP 下载，不参与依赖解析。如果卡在 Resolving dependencies，那和镜像无关，得收紧 php 版本约束、清理 require-dev、或检查是否用了废弃的 asset 插件。
