Composer无“恢复默认”功能,其行为是未配置repo.packagist时自动走https://packagist.org;需按环境变量>项目级repositories>全局配置顺序逐层排查并清理,用composer config -g repo.packagist composer https://packagist.org/覆盖而非删除,并强制执行composer clear-cache验证。

Composer 没有“恢复默认系统设置”这个功能,所谓“导出的默认设置”并不存在——它的行为是:只要没显式配置 repo.packagist,就自动走 https://packagist.org。你真正要做的,是清除所有覆盖官方源的配置层,并确保缓存不干扰。
查清当前实际生效的镜像源在哪一层
Composer 查源顺序固定为:环境变量 > 当前项目 composer.json 中的 repositories > 全局 config.json。只看 composer config -g repo.packagist 容易误判。
- 查环境变量:
echo $COMPOSER_REPO_PACKAGIST(Linux/macOS)或echo %COMPOSER_REPO_PACKAGIST%(Windows),有输出就说明它在最高层起效 - 查当前项目实际用的源:
composer config repo.packagist(不加-g),这个命令会合并所有层级后返回真实值 - 查全局配置是否还残留:
composer config -g repo.packagist,注意键名必须是单数repo.packagist;若输出Key "repo.packagist" does not exist,说明该层已干净
用覆盖代替删除,避免 Composer 2.2–2.4 的 fallback 缺陷
直接删 repos.packagist 或 repo.packagist 字段,在 Composer 2.2–2.4 小版本中可能触发 Could not parse version constraint 错误,且不报错、静默失败。更稳的方式是强制覆盖为官方地址。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 全局切回官方源:
composer config -g repo.packagist composer https://packagist.org/(注意末尾斜杠和composer类型前缀) - 仅当前项目临时切回:
composer config repo.packagist composer https://packagist.org/(不加-g) - 如果之前混设过
repo.packagist和repos.packagist,建议都清理:composer config -g --unset repo.packagist和composer config -g --unset repos.packagist
缓存不清 = 配置白改
Composer 把镜像源的 packages.json 快照存在本地缓存里,不清理就会继续读旧数据,导致 composer update 找不到新包、版本号错乱、锁文件更新失败。
- 必须执行:
composer clear-cache(不是dump-autoload,也不是删vendor/) - 验证是否真生效:
composer require monolog/monolog --no-install -vvv,滚动日志里找Downloading https://行——正确应为https://repo.packagist.org/,不是任何镜像域名 - 如果仍走镜像,大概率是项目
composer.json里还留着"repositories"块,得手动删或运行composer config --unset repositories
最常被忽略的是环境变量和项目级 repositories 的双重屏蔽,以及 URL 缺少 composer 类型前缀或末尾 / ——这两个细节写错,Composer 就静默 fallback 到官方源,但不会提示你哪里错了。










