composer换源无效的根本原因是配置错误导致静默回退官方源；唯一可信验证是执行composer config -g repo.packagist，输出必须为完整json（含type和带/结尾的url），否则即未生效，常见错误包括键名多s、漏type参数、url缺/、被项目级repositories覆盖。
国内镜像不是“更快的官方源”，而是独立同步的替代仓库；配置错误时它会静默回退到官方源，且不报错——这才是大多数人遇到“换源无效”的根本原因。
composer config -g repo.packagist 配置是否生效？只看这一行输出
执行 composer config -g repo.packagist，唯一可信结果只有两种：
- 返回完整 JSON 对象，如
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}→ 真生效 - 返回空、
null、"https://packagist.org"或直接报错 → 没生效，仍在走官方源
常见失效点：
- 命令写成
composer config -g repos.packagist（多一个s）→ Composer 完全忽略，不提示也不报错 - 漏掉中间的
composer类型参数：composer config -g repo.packagist https://xxx→ 新版 Composer 当作普通仓库处理，后续仍 fallback 到官方源 - URL 少了末尾
/，比如写成https://mirrors.aliyun.com/composer→ 请求路径拼成/composerpackages.json，404 后静默降级
项目级 composer.json 里的 repositories 会彻底屏蔽全局设置
只要当前目录下 composer.json 包含 "repositories" 字段，无论内容是否为空、是否包含有效镜像，全局配置 repo.packagist 都会被无视。
典型误配场景：
-
"repositories": [{"type": "composer", "url": "https://packagist.org"}]→ 明明想关掉官方源，结果反而强制走它 -
"repositories": {"packagist.org": false}→ 这是禁用官方源的正确写法，但很多人漏掉"packagist.org": false而只写了 URL - CI 构建失败时，第一件事不是查网络，而是
grep -n repositories composer.json—— 团队成员本地配了全局镜像，却把带旧配置的composer.json提交到了 Git
镜像再快，也救不了“还没同步”的包
所谓“快”，90% 不是响应时间，而是同步延迟。官方源上刚发布的 dev-main 或私有包，在镜像里可能根本不存在。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证同步状态最准的方式：
- 浏览器打开
https://mirrors.aliyun.com/composer/packages.json，查看末尾"lastUpdated"时间戳 - 对比
https://packagist.org/packages.json的同字段，差值 ≤ 90 秒属正常；超过 5 分钟就别指望装dev-分支 - 小众包或 GitHub 私仓默认不进镜像，此时 Composer 会 fallback 到官方源，若你又禁用了
"packagist.org": false，就直接报Package not found
阿里云目前同步延迟最低（实测 ≤ 90 秒），清华源教育网内快但南方用户偶发 DNS 解析慢，SJTUG 和 USTC 更适合 CI 流水线等对稳定性要求高于速度的场景。
为什么换镜像后 composer install 还卡在 “Loading composer repositories”？
这不是镜像慢，而是请求根本没发出去——大概率被项目级配置拦截了。
排查顺序必须是：
- 先运行
composer config -g repo.packagist和composer config repo.packagist（无-g），确认哪一层在起作用 - 检查
composer.json是否存在"repositories"字段，尤其注意有没有"packagist.org": false这类彻底关源的写法 - 临时验证镜像可达性：
curl -I https://mirrors.aliyun.com/composer/packages.json，返回200 OK才算服务正常 - 清元数据缓存：
composer update --refresh（不是clear-cache），否则本地仍复用 15 分钟前的旧索引
真正容易被忽略的点：全局配置只对当前用户生效。CI runner、Docker 容器、宝塔后台 PHP 进程，往往用的是不同用户或没有 ~/.composer/config.json，这时项目级配置才是唯一可靠方案。
