直接换阿里云镜像源就能解决90%的Composer下载问题，但必须严格满足三要素：键名repo.packagist（单数）、type值为composer、URL以https://开头且末尾带/，缺一则静默回退官方源；验证需执行composer config -g repo.packagist输出完整JSON。
直接换阿里云镜像源就能解决 90% 的 Composer 下载慢、超时、失败问题，但绝大多数人配不成功，不是网络不行，是 composer config -g repo.packagist 这条命令写错了三个硬性条件。
为什么 composer config -g repo.packagist 总是静默失效
这条命令不报错、不提示、也不拒绝执行，但只要漏掉以下任一条件，Composer 就自动 fallback 到 https://repo.packagist.org，你根本察觉不到：
-
repo.packagist键名不能写成repos.packagist（多一个 s）、packagist.org或repositories.packagist - 中间的
composer是 type 值，不是可选参数，也不能换成packagist或留空 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠在 Composer 2.2+ 会 404 或静默回退）
验证是否写入成功，只看这一行输出：composer config -g repo.packagist
必须返回完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错、或只返回字符串（新版行为），都说明失败。
项目级配置比全局更可靠，尤其在宝塔/CI 环境
全局配置写在 ~/.composer/config.json（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Composer\config.json（Windows），但它只对当前用户生效。而宝塔「一键部署」、计划任务、GitHub Actions 默认以 www 或 runner 用户运行，根本读不到你的配置。
进项目根目录后，执行：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 文件仍指向官方源
composer install 卡在 Resolving dependencies？镜像没用
镜像只加速下载环节（Downloading、Fetching package），不参与依赖解析。如果你看到日志卡在 Resolving dependencies 超过 10 秒，和镜像完全无关，问题出在本地约束太松：
-
"php": "^7.4 || ^8.0"这类宽泛版本号会让求解器尝试大量组合 -
"monolog/monolog": "*"或"dev-main"这类未锁定版本会触发元数据爆炸式请求 - 项目含大量
require-dev工具（如phpstan、infection），尤其老 Yii2 项目残留的fxp/composer-asset-plugin会额外请求 Bower/NPM 源（无国内镜像）
此时换镜像毫无意义。应收紧版本约束、清缓存（composer clear-cache）、禁用 xdebug，再试。
验证镜像是否真正生效的三步法
别只信 config -g 输出，实际请求路径才是最终判断依据：
- 执行
composer diagnose，检查输出中Repo packagist.org:后面是否为你配置的镜像地址 - 加
-vvv参数重跑安装：composer install -vvv，搜索日志里是否出现GET https://mirrors.aliyun.com/composer/... - 临时用
--repository-url强制走镜像：composer install --repository-url=https://mirrors.aliyun.com/composer/（注意：该参数对require无效）
真正容易被忽略的是：项目已有 "repositories": { "packagist.org": false } 这类配置时，镜像会被彻底屏蔽——它连基础包（如 php、ext-json）都校验不过，不是慢，是根本装不上。
