换镜像源必须严格满足三个条件：键名是repo.packagist（单数）、type值显式写为composer、URL以/结尾，否则Composer会静默回退至packagist.org。
换镜像源不是“试试看”，而是必须严格满足三个条件，否则 Composer 会静默 fallback 回 packagist.org，你根本收不到任何提示——所有“Failed to download”“Content-Length mismatch”“Could not resolve host”问题，90% 都卡在这一步。
为什么 composer config -g repo.packagist 总是不生效
它不是报错，是彻底被忽略。三个硬性条件缺一不可：
- 键名必须是
repo.packagist（单数，不能是repos.packagist或repositories.packagist.org） - 中间的
composer是 type 值，必须显式写出：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径时变成/packages.json→/composer/packages.json，直接 404）
验证是否写进去了，只看这一条命令：composer config -g repo.packagist。输出必须是完整 JSON（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}），空、null、或仍是 https://packagist.org，说明根本没配进去。
换源后仍卡在 Downloading，怎么确认真用了镜像
别信配置输出，要看实际请求域名：
- 运行
composer diagnose，找到Repo packagist.org:这一行，后面显示的域名必须是你配的镜像地址（比如mirrors.cloud.tencent.com） - 新建空目录，执行
composer init -n && composer require monolog/monolog -vvv，日志第一行Downloading https://...的域名必须匹配你的镜像 - 如果仍看到
packagist.org，立刻检查项目级配置是否覆盖：运行composer config repo.packagist（无-g），若返回非空，说明项目composer.json里的repositories段已生效，全局配置完全失效
常见静默 fallback 场景：项目 composer.json 里有空 "repositories": []，或 composer.lock 里记录的是原官方 dist.url，得删掉 vendor/ 和 composer.lock 再重装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
当前稳定可用的国内镜像地址（2026 年实测）
阿里云、腾讯云、华为云三个源目前可用，但注意细节：
- 阿里云：
https://mirrors.aliyun.com/composer/（DNS 快，电信延迟低，末尾斜杠不可省） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（华南地区延迟最低，私有源兼容性强） - 华为云：
https://repo.huaweicloud.com/repository/php/（注意不是mirrors.huaweicloud.com，后者自 2026 年起全部 404）
清华、Laravel China、PHPComposer 等镜像均已下线或不稳定，不再推荐。设腾讯云为例：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/。
换源后还失败？优先清缓存再验证
composer clear-cache 不是可选项，是必做动作。缓存里可能存着损坏的 zip 包或旧的 packages.json，不清理就会一直复用失败路径：
- 先查缓存路径：
composer config --global cache-dir - 进入该目录，手动确认
downloads/和files/子目录为空 - 清完后跑
composer install -vvv，观察日志是否出现Downloading而非Using cache - 若仍卡在
Reading /packages.json from cache，说明缓存没清干净，需手动删整个缓存目录
真正容易被忽略的点是：镜像配置正确 ≠ 请求走镜像。缓存污染、项目级配置覆盖、URL 少斜杠这三件事，任何一个出错，Composer 都不会报错，只会安静地连回 packagist.org，然后等你花十分钟看日志发呆。
