Composer镜像源切换失败主因是配置写错（如键名误为repos.packagist）、被项目级repositories字段覆盖、或未执行composer clear-cache，三者任一即静默失效；验证须交叉比对config输出、diagnose结果及-vvv日志中的实际请求URL。

源切换失败不是 Composer “没切”，而是它压根没按你想的走那个地址——配置写错、被覆盖、缓存没清，三者占其一，就等于白操作。

为什么 composer config -g repo.packagist 不生效

最常见原因就三个，且全都不报错，静默失效：

• repo.packagist 写成 repos.packagist（多一个 s）或 repositories.packagist.org（新版键名）——Composer 2.2+ 已弃用 repo.packagist，但旧写法在部分版本里仍可用；若你用的是 2.2+，必须用 repositories.packagist.org，否则字段被忽略
• 项目根目录 composer.json 里存在 "repositories" 字段（哪怕空数组 []），全局配置立刻失效，优先级为：环境变量 > 项目级 repositories > 全局 repositories.packagist.org
• 没运行 composer clear-cache，本地缓存仍指向旧源的 packages.json，Composer 根本不发新请求，直接读缓存

怎么确认当前真正生效的源地址

不能只信 composer config 的输出，得看三处是否一致：

• 查配置：composer config -g repositories.packagist.org（2.2+）或 composer config -g repo.packagist（旧版）输出必须是完整 JSON，url 值为你设的镜像地址，结尾带 /
• 看诊断：composer diagnose 输出中 “Repo:” 行显示的域名，必须和你配的镜像一致
• 抓真实请求：composer show -p | head -3 第一行显示的源域名；更准的是加 -vvv 跑一次 composer update，日志里 Downloading 的 URL 应含 mirrors.aliyun.com 或对应地址

临时强制走某个源比永久改配置更安全

尤其在 CI、多人协作或调试时，硬改全局配置容易污染环境、难以追溯：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 单次命令指定源：composer create-project laravel/laravel myapp -r https://mirrors.aliyun.com/composer/
• 仅当前项目生效（不写进 composer.json）：composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/
• 完全绕过所有配置强制走某地址：composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/composer/，适合快速验证镜像可用性

换源后必须清缓存，否则等于没换

composer clear-cache 不是可选项，是硬性前提。缓存里存着旧镜像下载的 packages.json 快照，不清掉，Composer 仍会按旧元数据解析依赖，结果就是 composer update 找不到新包、锁文件更新失败、版本号对不上。

验证是否清干净：ls -la ~/.composer/cache/（Linux/macOS）或 dir %APPDATA%\Composer\Cache\（Windows）应为空或只剩空子目录。更彻底的方法是临时改缓存路径：composer config -g cache-dir /tmp/composer-cache-empty，再运行一次 clear-cache。