答案是必须同时满足四要素：带-g、键名repo.packagist（单数）、type值composer、url为https且末尾带/，缺一即静默回退官方源；项目级配置需不加-g并确保repositories为对象结构，否则覆盖私有源；resolving dependencies卡顿与镜像无关，系本地约束过宽或dev包过多所致。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能解决 90% 的下载卡顿问题，但这条命令极易因拼写、参数或路径错误而静默失效——不报错，也不生效。
为什么 composer config -g repo.packagist 总是不生效？
它不是“差不多对就行”的命令，漏掉任意一个硬性条件，Composer 就会自动 fallback 到 https://packagist.org，且完全不提示。
-
-g缺失 → 只改当前目录的composer.json，换项目就失效 - 键名写成
repos.packagist（多一个s）→ 配置被忽略，composer config -g repo.packagist返回空或报错 - 漏掉中间的
composer（即 type 值）→ Composer 2.0+ 直接弃用该配置，回退官方源 - URL 少末尾
/→ 请求变成https://mirrors.aliyun.com/composerpackages.json，404 - 用了
http而非https→ 大部分镜像站已强制 HTTPS，连接失败
验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整结构。如果返回空、null 或 https://packagist.org，说明没写对。
项目级镜像怎么加才不破坏私有源？
团队协作或 CI 环境下，全局配置靠不住（比如宝塔用 www 用户执行，读不到你 root 的配置），必须把镜像写进项目本身。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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" - 如果原
composer.json是"repositories": {}（对象），命令会安全追加；如果是"repositories": []（数组），命令会报错，需先手动改成对象格式再重试 - 千万别写
"packagist.org": false—— 这会彻底禁用基础包索引，连php扩展依赖都校验不过
改完后务必删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update），否则旧 lock 文件仍指向海外源。
composer install 还卡在 “Resolving dependencies”？和镜像无关
镜像只加速元数据拉取和 ZIP 下载，不解决依赖解析慢的问题。如果你看到卡在 Resolving dependencies 几十秒以上，基本是本地约束或 composer.json 写法导致的：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束会让 Composer 尝试大量组合，大幅拖慢解析 -
require-dev里塞了太多未锁定版本的工具包（如"phpunit/phpunit": "dev-main"） - 项目用了已废弃的
fxp/composer-asset-plugin（常见于老版 Yii2），它额外请求 Bower 源，而这些源没有国内镜像
排查方法：加 -vvv 参数运行 composer install -vvv，看日志里是否真在请求镜像地址；如果请求的是 packagist.org，说明镜像根本没接管，先回第一部分检查配置。
最常被忽略的一点：镜像地址和并发设置必须配对。只换源不启 parallel-downloads，相当于给高铁修了新轨道却只开一节车厢——执行 composer config -g parallel-downloads 8 才能真正压满带宽。华为云、阿里云等主流镜像站都支持高并发，但默认仅开 3 线程。
