镜像源真生效需三步验证：先运行composer config -g repo.packagist确认输出为含末尾斜杠的完整JSON或URL；再执行composer config repo.packagist检查是否被项目级repositories覆盖；最后用composer install -vvv查看日志中是否有https---mirrors-aliyun-com-composer路径，否则仍在fallback官方源。
Composer依赖更新卡住、报错变快但问题还在，不是镜像没换对，而是你没清缓存、没验证是否真走镜像、也没意识到镜像只加速元数据下载——它不绕过SAT求解，也不掩盖conflict规则。
怎么确认镜像源真在生效？
别信“命令执行成功”，要看实际请求地址：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON 或纯 URL 字符串，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（注意末尾斜杠）；返回null、https://packagist.org或空，说明配置失败 - 进项目目录后运行
composer config repo.packagist，若有输出，说明项目级repositories字段已覆盖全局设置 - 再跑一次
composer install -vvv，最后几行必须出现类似Reading packages.json from cache at /https---mirrors-aliyun-com-composer/，否则仍在 fallback 到官方源
为什么换完镜像还是卡在Loading repositories？
常见静默失效原因有三个，全都会让 Composer 自动退回到 packagist.org：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repo.packagist写成repos.packagist（多一个 s），Composer 2.x 会静默忽略，不报错也不生效 - URL 缺少末尾斜杠：
https://mirrors.aliyun.com/composer→ 404，正确写法是https://mirrors.aliyun.com/composer/ - 漏掉
composer类型声明：命令中必须带composer关键字，即composer config -g repo.packagist composer https://...
清缓存这一步为什么不能跳？
composer clear-cache 不是可选项，它是换镜像的前置必要动作：
- 缓存目录
~/.composer/cache/repo/里存着旧源的packages.json快照，哪怕你已改配置，Composer 仍按旧元数据解析，甚至返回 404 - Windows 用户路径是
%APPDATA%\Composer\Cache，别乱删其他位置；执行前可用composer config --global cache-dir确认真实路径 -
composer update --refresh（≥2.5）可强制刷新元数据缓存，但它不替代clear-cache——后者清的是整个 repo 目录，前者只丢 packages.json
镜像提速后报错更快，但冲突还在，怎么办？
换镜像后 Resolving dependencies through SAT 卡顿消失、composer why-not 响应从 2 分钟缩到 1 秒，说明你终于拿到了准确元数据。这时该干的是定位而非换源：
- 先确保已执行
composer clear-cache和composer config -g repo.packagist验证镜像生效 - 运行
composer why-not laravel/framework:11.0（注意版本号写法，11≠11.0） - 若输出为空，不是镜像问题，是你根本没在
composer.json中声明该包，或版本格式错误 - 真正硬冲突逃不过：PHP 平台约束太宽（
"php": ">=7.4"）、混用dev-main和稳定版、conflict字段显式拦截——这些换十次镜像都无效
镜像只是代理层，不是魔法。最常被忽略的其实是缓存残留和配置优先级——项目级 repositories 覆盖全局、环境变量 COMPOSER_REPO_PACKAGIST 比所有 config 都高、clear-cache 后没重试就断定“没用”，这些才是卡住你的真正节点。
