为什么Composer一直卡着？教你换成Composer中文镜像-composer-PHP中文网

composer国内镜像配置生效需同时满足三个条件：键名必须为repo.packagist（单数）、命令末尾必须显式指定composer类型值、镜像url必须以/结尾；且项目composer.json中若存在repositories字段则全局配置失效，还需清理缓存、验证配置输出并查看-vvv日志确认真实请求地址。

为什么composer一直卡着？教你换成composer中文镜像

composer 卡在 “Loading composer repositories” 或反复重试下载，不是网络差，是根本没走国内镜像——配错一个字符（比如少个 /、拼错 repo.packagist）就会静默 fallback 到 packagist.org，连错误都不报。

为什么 `composer config -g repo.packagist` 总不生效？

这不是命令没运行，而是三个硬性条件缺一不可，漏一个就等于没配：

键名必须是 repo.packagist（单数，不能写成 repos.packagist 或 repositories.packagist）
命令末尾必须显式带上 composer 类型值，例如：composer config -g repo.packagist composer @#@#@#@#@#@#@#@#@#@0；漏掉 composer 会直接退回到官方源
URL 必须以 / 结尾：@#@#@#@#@#@#@#@#@#@0 ✅，@#@#@#@#@#@#@#@#@#@2 ❌（拼接路径变成 /composerpackages.json，直接 404）

验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 URL 字符串或标准 JSON 对象，形如 {"type": "composer", "url": "@#@#@#@#@#@#@#@#@#@0"}。空、null、或含 packagist.org，说明根本没生效。

项目里有 `repositories` 字段，全局镜像就失效

只要项目根目录的 composer.json 里存在 "repositories" 字段（哪怕只是 {} 或 []），全局配置 repo.packagist 就会被完全跳过。

常见陷阱包括：

"repositories": {}（空对象）
"repositories": []（空数组，此时 composer config repo.packagist 会报错）
"repositories": [{"type": "composer", "url": "@#@#@#@#@#@#@#@#@#@4"}]（显式写了官方源）

临时绕过方法：加 --repository=@#@#@#@#@#@#@#@#@#@0 参数，例如 composer install --repository=@#@#@#@#@#@#@#@#@#@0

彻底解决方法：手动删掉 composer.json 中整个 "repositories" 区块（注意保留逗号和缩进），再执行 composer clear-cache。

Composer

Composer 是 PHP 生态常用依赖管理工具，用于安装框架、组件和项目依赖。

下载

`composer.lock` 里还存着旧源地址，换镜像也没用

composer.lock 文件记录的是每个包的 dist.url，它指向原始 packagist.org 的 ZIP 地址。即使镜像已生效，composer install 仍会优先尝试这个旧 URL，卡在下载环节。

必须强制刷新 lock 文件里的源信息：

删除 vendor 和 composer.lock
运行 composer install -vvv，观察日志中是否出现 mirrors.aliyun.com 或 tuna.tsinghua.edu.cn
或保留 lock 文件但强制更新源链接：composer update --lock

另外，某些包只提供 source（Git）方式，镜像不代理 Git 流量，--prefer-dist 会失败并退化为慢速 clone——可用 composer show vendor/package -vvv 看真实请求域名确认。