Composer设置国内镜像指南_提升安装依赖速度

为什么 composer install 卡在 “Loading composer repositories”

大概率是默认源 https://packagist.org 在国内解析慢或连接不稳定，不是你网络差，也不是项目有问题。Composer 每次安装前会先全量拉取包元数据（metadata），这个过程走的是 HTTPS，受 DNS、TLS 握手、CDN 节点距离影响极大。镜像不是“加速下载包文件”，而是替换元数据接口和 ZIP 包分发节点——两者必须匹配，否则会报 Package not found 或 Signature mismatch。

全局换源：用 composer config -g repo.packagist 最稳妥

推荐使用清华、阿里或华为的镜像，它们同步频率高（通常 5 分钟内）、支持 HTTPS 和完整元数据。执行以下命令之一即可：

composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

注意：repo.packagist 是固定键名，不能写成 packagist.org；composer 是 type 字段，不能省略；末尾斜杠 / 必须保留，否则部分版本会拼接出错。

验证是否生效：

composer config -g repo.packagist

输出应为一个关联数组，包含 type: "composer" 和 url 字段。

项目级换源：修改 composer.json 的 repositories 数组

适合需要临时测试不同镜像、或团队要求源地址显式声明的场景。在项目根目录的 composer.json 中添加：

"repositories": [ { "type": "composer", "url": "https://mirrors.tuna.tsinghua.edu.cn/composer/" }]

⚠️ 不要删掉原有 repositories（如果有），直接追加；如果已有非 packagist 官方源（如私有包仓库），需确保它们仍保留在数组中，否则那些包会不可见。

改完后运行：

composer update –lock

让 composer.lock 重新生成并记录新源地址。

换源后仍慢？检查是否被 fxp/composer-asset-plugin 拖累

如果你的项目依赖 yii2 或老版本前端资源包，很可能启用了已废弃的 fxp/composer-asset-plugin。它会额外请求 Bower/NPM 源，而这些源没国内镜像，且插件本身不走 Composer 镜像配置。

解决办法：

升级到 yiisoft/yii2 2.0.14+，改用 npm-asset-packagist.org 或直接迁移到 yarn/npm执行 composer global remove fxp/composer-asset-plugin 彻底卸载确认 composer.json 中没有 "fxp/composer-asset-plugin" 相关配置

这类问题不会报错，但会让 install 卡在 “Installing dependencies” 阶段长达数分钟——它其实在等超时。

镜像只是把远程仓库“搬近一点”，但 Composer 的依赖解析逻辑、锁文件一致性、插件兼容性这些底层机制没变。最常被忽略的是：换源后没清缓存，或者误以为改了 config.json 就自动生效——其实必须通过 config 命令写入或重生成 lock 文件才算真正切换。