全局配置 Composer 镜像需同时满足三个条件：键名必须为 repo.packagist（非 repos）、type 值必须为 composer、URL 必须以 / 结尾且带 -g 参数；验证需用 composer config -g repo.packagist 输出完整 JSON，否则配置失败。
直接运行这条命令就能全局生效
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可完成配置，90% 的本地开发场景下这是最快解法。但必须同时满足三个硬性条件，缺一就会静默失效：
-
repo.packagist不能写成repos.packagist（多一个s就彻底无效，且不报错） - 中间的
composer是type值，不可省略或替换成https等其他字符串 -
https://mirrors.aliyun.com/composer/必须以斜杠/结尾，少一个就拼出错误路径导致 404 - 必须带
-g，漏掉就只改当前目录下的composer.json，换个项目就回退
验证是否真生效，别信感觉
运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
如果返回空、null、报错或提示 Key "repo.packagist" does not exist，说明没写成功。
- 常见原因：拼写错误、漏
-g、URL 不合规（比如少斜杠或用 HTTP） - 注意：进到某个项目后执行
composer config repo.packagist看到的是项目级设置，不代表全局无效 - 最可靠验证方式是加
-vvv：运行composer install -vvv 2>&1 | grep "Downloading"，观察日志里出现的域名是不是mirrors.aliyun.com
项目级配置更适合团队协作和 CI
全局配置在宝塔、CI 或多用户环境下容易因执行用户不一致而失效（比如你在终端用 root 配了，但宝塔后台用 www 用户跑命令）。推荐进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它会自动往
composer.json顶层添加"repositories"字段，key 固定为"packagist" - 如果项目已有
"repositories": {}（对象），命令安全合并；如果是数组格式（"repositories": []），会报错，需先手动改成对象 - 改完建议删掉
vendor/和composer.lock，再运行composer install，避免旧 lock 文件里的 hash 与镜像元数据不匹配
换源后还是卡在 “Resolving dependencies”？镜像不背这个锅
镜像只加速下载阶段，对依赖解析过程完全无影响。如果你发现卡在 Resolving dependencies，和网络无关，典型诱因有：
-
composer.json中 PHP 版本约束太宽，比如"php": "^7.4 || ^8.0 || ^8.1"，让求解器暴力试遍所有组合 - 存在
"minimum-stability": "dev"，强制拉取不稳定分支，候选版本数爆炸 - 项目
composer.json的"repositories"字段指向了已下线私有源，Composer 逐个超时才 fallback - 用了已废弃的
fxp/composer-asset-plugin（常见于老版 Yii2），它不走 Composer 镜像配置，额外请求 Bower/NPM 源
真正容易被忽略的是：项目级 "repositories" 配置会直接覆盖全局镜像，这是最常被忽视的失效原因。查一遍 composer config -l | grep repositories.packagist，如果输出带项目路径，就坐实是它在作祟。
