答案是:因键名必须为repo.packagist(单数小写无s)、需带-g参数、URL末尾必须有/且用HTTPS,三者缺一即静默回退官方源;验证须输出完整JSON如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。

直接配 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效,但漏掉任意一个细节都会静默失败——不是报错,而是根本没切过去。
为什么 composer config -g repo.packagist 总是不生效
它不提示错误,但请求依然打向 packagist.org,90% 是因为三个硬性条件缺一不可:
-
repo.packagist键名不能写成repos.packagist(多一个s就被忽略) - 中间的
composer是type值,不是注释或可选参数;省略后 Composer 2.0+ 会 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须带末尾斜杠/,少斜杠会拼出/packages.json导致 404
验证是否真写进去了:运行 composer config -g repo.packagist,输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON。空、null、或仍是 https://packagist.org,说明没成功。
全局配置 vs 项目级配置:谁更可靠
全局配置写入 ~/.composer/config.json(Windows 是 %USERPROFILE%\AppData\Roaming\Composer\config.json),所有项目默认读它;但项目级配置写在当前项目的 composer.json 的 repositories 字段里,优先级更高——哪怕你刚配好全局,只要 composer.json 里有 repositories,就会被覆盖且不报错。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 个人开发机用全局:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI/CD 或团队协作时用项目级:
composer config repo.packagist composer https://mirrors.aliyun.com/composer/(去掉-g,确保在项目根目录下运行) - 宝塔、Docker 等多用户环境,先确认执行用户(比如
whoami),再针对性配置,例如:sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后还是卡在 “Loading composer repositories” 怎么办
镜像本身没问题,卡顿往往来自缓存或残留元数据:
- 先清缓存:
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 加
-vvv重试:composer install -vvv,看日志里请求域名是不是mirrors.aliyun.com - 旧版 Composer 1.x 不识别
repo.packagist,得用composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/(注意是repos)
composer create-project 为什么不受镜像影响
这个命令默认绕过本地配置,直接硬编码访问 packagist.org,镜像配置对它无效:
- 必须显式指定镜像源:
composer create-project laravel/laravel myapp --repository=https://mirrors.aliyun.com/composer/ - 或者用别名方式(更简洁):
composer create-project -r https://mirrors.aliyun.com/composer/ laravel/laravel myapp - 注意:
-r参数只在 Composer 2.2+ 支持,老版本得用完整--repository - 如果提示
Repository not found,大概率是镜像站同步延迟,可换清华源:https://packagist.mirrors.tuna.tsinghua.edu.cn
最容易被忽略的是:项目已有 repositories 数组时,composer config repo.packagist 会覆盖整个数组,不是追加——想保留私有源就得手动编辑 composer.json 或用其他工具处理。










