执行 composer config -g --unset repos.packagist 无效的主因是字段名错误(应删 repos.packagist 复数,而非 repo.packagist 单数)、未清元数据缓存(需手动删 ~/.composer/cache/repo/https---packagist.org/ 或用 --refresh),或被项目级 repositories 字段/环境变量覆盖。

执行 composer config -g --unset repos.packagist 后仍走镜像,不是命令没运行,而是配置残留、缓存未清或覆盖层级没理清——这三类问题占实际故障的 95% 以上。
为什么 composer config -g --unset repos.packagist 看似成功却无效?
Composer 2.x 实际读取的是 repos.packagist(复数、带 s),但很多教程和旧脚本写的是 repo.packagist(单数)。这两个字段完全独立,删错一个,另一个照常生效。
- 常见误操作:
composer config -g --unset repo.packagist→ 白删,repos.packagist还在 - 漏掉
-g→ 只删当前项目配置,全局不受影响 - 执行后不验证:应立刻运行
composer config -g repos.packagist,输出必须是Key "repos.packagist" does not exist或空
三层配置覆盖关系必须手动逐层检查
Composer 查源顺序是:环境变量 > 当前项目 composer.json 中的 repositories > 全局配置。哪怕全局删干净了,只要项目里写了 "repositories",它就优先生效。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 查项目级配置:
grep -A 5 '"repositories"' composer.json(Linux/macOS)或直接打开文件搜索 - 查环境变量:
echo $COMPOSER_REPO_PACKAGIST(Linux/macOS)或echo %COMPOSER_REPO_PACKAGIST%(Windows) - 临时绕过项目配置:
composer config repo.packagist composer https://repo.packagist.org(不加-g,只改当前项目) - 若项目中含
"packagist.org": false,删全局配置毫无意义,必须手动编辑composer.json删除整段repositories
缓存不清 = 白切源,且必须清对位置
composer clear-cache 默认只清 ~/.composer/cache/files/ 和部分 provider 索引,但最关键的元数据快照(packages.json 及 p/provider-*.json)仍留在 ~/.composer/cache/repo/https---packagist.org/ 里,且永不自动过期。
- 必须手动删整个目录:
rm -rf ~/.composer/cache/repo/https---packagist.org/(Linux/macOS)或对应 Windows 路径 - Composer ≥ 2.5 可用
composer update --refresh替代手动删目录,它会强制丢弃所有元数据缓存 - 删完别急着
install,先跑composer update --dry-run -v,观察日志是否出现Downloading https://repo.packagist.org/—— 出现才说明 metadata 真重拉了
验证是否真还原成功,不能只看命令输出
很多人删完配置、清完缓存就以为搞定了,结果 composer require monolog/monolog --no-install -vvv 日志里还是 mirrors.aliyun.com。
- 查配置只是第一步,真正要看的是实际请求 URL;
-vvv日志中Downloading行必须含https://repo.packagist.org - 如果仍见镜像域名,说明某层配置或缓存仍有残留,得回退到上一步重新排查
- 特别注意:某些 CI 流水线会把旧
composer.lock提交进 Git,它硬编码了 provider 地址,换源后也会持续触发 404










