如何通过Composer配置国内镜像加速国内安装依赖过程？

本文共计844个文字，预计阅读时间需要4分钟。

概括而言，Composer 在国内解析慢或连接不稳定时，可能并非网络差异或项目问题。在安装前，Composer 会先全面拉取包元数据（metadata），该过程通过 HTTPS 进行，受 DNS、TLS、CDN 和节点距离等因素影响极大。镜像不是加速下载文件，而是更换元数据接口和 ZIP 包分发包环节——两者必须匹配，否则会报找不到包或签名不匹配。

全局换源：用 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 字段。