Composer中文镜像配置失效主因是四个硬性条件未同时满足：键名必须为repo.packagist（非repos）、type值必填composer、URL末尾须带/、命令必须加-g；且项目级repositories字段会静默覆盖全局配置，缓存未清则仍请求packagist.org。
配了中文镜像还慢、报错、甚至完全没反应？90% 的问题不是镜像本身挂了，而是配置写错、缓存没清、或被项目级设置静默覆盖。
composer config -g repo.packagist 为什么总不生效
这条命令必须同时满足四个硬性条件，漏一个就静默失效，且不报错：
-
repo.packagist不能写成repos.packagist（多一个 s 就写进无效字段） - 第三个参数
composer是type值，不是可选注释——省略后 Composer 2.x+ 直接 fallback 到https://packagist.org -
url必须以/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/packages.json导致 404 - 必须加
-g：漏掉就只改当前目录的composer.json，换个项目就失效
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 或纯 URL 字符串，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或含 packagist.org，说明根本没写进去。
换源后 composer install 还卡在 packagist.org
镜像只加速下载，不改变优先级逻辑。只要项目根目录 composer.json 里存在 repositories 字段（哪怕只是空数组 {} 或 []），全局配置就会被跳过。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目目录执行
composer config repositories，看实际生效的url是什么 - 检查是否写了
"packagist.org": false—— 这会直接屏蔽所有包源 - 某些 CI 环境（如 GitLab Runner）以
www-data用户运行，但composer config -g写进了/root/.composer，实际读不到 - 最准验证方式：
composer install -vvv | grep "Downloading.*packages.json"，日志里出现的域名才是真实请求地址
为什么 clear-cache 这一步不能跳过
缓存里存着旧的 packages.json 和 provider 元数据，Composer 会优先读本地缓存再校验远程地址——哪怕你已经切了镜像，它仍可能反复尝试从 https://packagist.org 拉取索引，卡在 DNS 解析或 TLS 握手阶段。
- 执行
composer clear-cache（不是composer cache-clear，后者已废弃） - 看到
Clearing cache (cache-dir):和Clearing cache (cache-vcs):两行才算成功 - 临时绕过缓存验证：
composer install --no-cache -vvv，看日志里请求的是哪个域名 - 缓存路径默认在
~/.composer/cache（Windows 是%APPDATA%\Composer\cache），可手动rm -rf清空
composer install -vvv 日志里该盯哪些关键行
别信 composer diagnose，它硬编码只连 packagist.org，和你的镜像配置无关。真正有效的验证只看安装日志：
- 找
Reading packages.json from cache at后面的路径：出现https---mirrors-aliyun-com-composer才算走对了 - 找
Downloading https://开头的行：域名必须是你的镜像地址，比如mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn - 如果看到
https---packagist-org或https---packagist-laravel-china-org，说明 fallback 了，当前命令仍在走海外源 - 若卡在
Resolving dependencies阶段，和镜像无关——那是 PHP 版本约束太宽、minimum-stability设为dev或composer.lock缺失导致的
镜像配置本身很简单，难的是每个细节都得对：键名、type、斜杠、-g、clear-cache、以及确认没被项目级配置盖掉——少一个，就等于没配。
