先确认镜像配置是否生效：运行composer config -g repo.packagist应输出阿里云等有效地址，再执行composer config repositories检查项目级是否覆盖；必须composer clear-cache并验证缓存目录为空，否则配置无效。
镜像配置写了，composer install 还是慢如蜗牛或直接报错？大概率不是镜像本身挂了，而是配置根本没生效，或者被其他东西悄悄覆盖了。
怎么确认当前走的是哪个镜像地址
别信自己记的命令，也别只看 composer config -g --list 的大段输出。Composer 7+ 只认 repositories.packagist.org 这个键，其他像 repo.packagist 或 repos.packagist 都是旧写法，可能残留但已不生效。
分两步查：
- 全局实际生效源：
composer config -g repo.packagist—— 有输出且是阿里云/清华地址才算成功 - 项目级实际生效源：
composer config repositories（在项目目录下执行）—— 找到"packagist.org": { "type": "composer", "url": "..." }这一项，它的url值才是 Composer 真正请求的地址
如果这两处都为空，说明你还在直连 https://packagist.org，镜像压根没接上。
为什么 composer diagnose 报错但 install 能用
composer diagnose 是个“假朋友”：它硬编码只连 https://packagist.org，完全不读你的镜像配置，也不受 COMPOSER_REPO_PACKAGIST 环境变量影响。所以它失败 ≠ 你日常不能用。
验证镜像是否真可用，该用这个：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer -vvv show -p | head -5—— 日志里出现的GET https://xxx/composer/packages.json才是真实请求地址 - 临时让
diagnose测镜像：先删掉全局镜像composer config --global --unset repos.packagist，再跑diagnose - 某些镜像会静默拦截默认 UA，手动测：
curl -v -A "Composer/2.5" https://mirrors.aliyun.com/composer/packages.json
缓存不清理，配了也白配
Composer 缓存包元数据，默认存在 ~/.composer/cache（Windows 是 %APPDATA%\Composer\cache）。改完镜像不清理缓存，它照样从旧缓存里读失效地址，表现就是“配置写了，但请求 URL 没变”。
必须清：
composer clear-cache-
rm -rf ~/.composer/cache/*（Linux/macOS）或手动删 Windows 缓存目录 - 验证是否清干净：
ls -la ~/.composer/cache，确认目录为空
注意：有些 CI 环境（如 GitHub Actions）每次都是干净容器，缓存天然不存在，这时候问题更可能出在 DNS、代理或镜像本身状态。
项目级 repositories 覆盖全局配置
项目根目录的 composer.json 里如果写了 "repositories" 字段，它的优先级高于全局镜像。常见陷阱：
- 硬编码了已下线的镜像，比如
"https://packagist.phpcomposer.com"（2020 年起不可用） - 写了
"packagist.org": false却忘了补上可用的composer类型源 - 清华镜像少了末尾斜杠：
"https://mirrors.tuna.tsinghua.edu.cn/composer"→ 404，正确是"https://mirrors.tuna.tsinghua.edu.cn/composer/"
检查方式：composer config repositories 输出里，只要看到 packagist.org 对应的 url 不是你想用的镜像，就得去改 composer.json 里的 repositories 段。
最常被忽略的一点：改完配置后不验证真实请求 URL，只盯着 config 命令输出看；还有人清缓存只跑 clear-cache，却没删掉 ~/.composer/cache 下残留的子目录，导致缓存依然生效。
