最准最快的方式是执行composer config -g repo.packagist,直接读取全局配置文件~/.composer/config.json,三秒内确认镜像是否生效;输出url表示已启用对应镜像,为空或报错则走官方源。

直接查全局配置:composer config -g repo.packagist
这是最快、最准的方式,三秒内就能确认你是否真用了国内镜像。它只读 ~/.composer/config.json,不依赖网络、缓存或当前目录。
执行后出现以下几种情况:
- 输出类似
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}→ 阿里云镜像已生效 - 输出空或报错
Key "repo.packagist" does not exist→ 当前走官方源https://packagist.org - 输出
https://packagist.org(字符串而非 JSON)→ 手动设过但没用对象格式,新版 Composer 会静默忽略
常见踩坑点:
- 漏掉
-g参数,变成composer config repo.packagist,结果查的是当前项目级配置,容易误判 - 键名拼错,比如写成
repos.packagist(多一个 s)或repositories.packagist.org(旧写法),Composer 2.2+ 不认 - PowerShell 下 URL 被截断,加引号:
composer config -g "repo.packagist"
验证是否真在用这个镜像:加 -vvv 看真实请求
配置写了 ≠ 请求发出去了。缓存、环境变量、代理都可能让流量绕过你设的地址。
运行一次真实操作并观察日志:
composer show monolog/monolog -vvv 2>&1 | grep "GET https"- 看到
GET https://mirrors.aliyun.com/composer/p2/monolog/monolog.json→ 真正在用镜像 - 看到
GET https://repo.packagist.org/packages.json→ 还在连官方源,镜像未生效
必须先执行 composer clear-cache 再试,否则旧缓存会掩盖配置变更。
还要检查环境变量是否覆盖:
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
- Linux/macOS:
echo $COMPOSER_REPO_PACKAGIST - Windows cmd:
echo %COMPOSER_REPO_PACKAGIST% - 如果输出非空(比如
https://packagist.org),那无论config -g显示什么,实际都走这个地址
别信 composer diagnose 的“Repo packagist.org is not configured”
这条输出不是警告,恰恰说明镜像已接管。Composer 默认内置官方源,一旦你用 repo.packagist 覆盖了它,diagnose 就会如实反馈“没配官方源”。
真正要看的是它下面这行:
-
Repo packagist.org: https://mirrors.tuna.tsinghua.edu.cn/composer/→ 表示清华源已生效 - 但如果这行根本没出现,或者显示
https://packagist.org,才说明配置没起作用
注意:composer diagnose 不验证镜像连通性,只检查 PHP 环境和 cURL 是否可用。即使显示 OK,也可能卡在元数据拉取阶段。
查所有相关配置项:composer config --list | grep repo
想一次性看清所有镜像相关设置,用这个命令:
-
composer config --list | grep repo(Linux/macOS) -
composer config --list | findstr repo(Windows)
重点关注这几项:
-
repo.packagist:主镜像,优先级最高(Composer 2.2+) -
repos.packagist.org:旧版写法,兼容用,但新版优先认前者 -
repositories.xxx:自定义仓库,比如公司私仓或特定组织镜像,可能覆盖部分包请求
如果项目 composer.json 里有 "repositories" 数组,它的优先级高于全局配置 —— 即使 config -g 显示阿里云,项目里写了腾讯云,实际就走腾讯云。










