最常用、最安全的方式是用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局切换至阿里云镜像,该命令自动写入~/.composer/config.json且兼容多数版本;注意url须以/结尾,执行后需运行composer clear-cache并验证composer config -g repo.packagist输出是否正确。

Composer 默认源在国内下载极慢甚至超时,直接换阿里云或腾讯云镜像就能解决,不需要改配置文件或重装。
用 composer config 临时切全局镜像
这是最常用、最安全的方式,修改的是当前项目的 composer.json(加 --global 则影响全局):
- 切换为阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 切换为腾讯云镜像:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 恢复默认源(删掉镜像设置):
composer config -g --unset repos.packagist
注意:repo.packagist 是旧写法,新版本 Composer(2.2+)推荐用 repos.packagist;如果执行报错提示 key 不存在,说明你用的是新版,改用 repos.packagist 参数即可。
检查镜像是否生效
别只看命令有没有报错,得验证实际请求走的是哪个域名:
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
composer config -g repos.packagist,输出应为类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 执行
composer show -p | head -5,观察第一条请求的 URL 域名是否已变成镜像站 - 更直接:删掉
vendor和composer.lock,再跑composer install,看终端里下载地址是不是mirrors.aliyun.com或mirrors.cloud.tencent.com
常见误区:改了但没加 -g,结果只改了当前项目,换个项目又变慢;或者用了 --global 却查的是项目级配置,误判失败。
为什么不用改 ~/.composer/config.json 手动编辑
手动编辑容易出格式错误(比如多一个逗号、引号不闭合),导致后续所有 composer 命令报 JSON decode error;而且不同 Composer 版本对字段命名要求不同(repo.packagist vs repos.packagist),手动写极易不兼容。
除非你在 CI 环境里需要预置配置,否则一律用 composer config 命令操作——它会自动适配当前版本的字段规范,并校验 JSON 合法性。
镜像不是万能的:部分私有包、GitHub 直链包(如 "type": "package")、或启用了 packagist.org 强制白名单的项目,仍会回源。这时候得单独配 repositories,而不是指望全局镜像。










