已生效的华为云镜像地址是https://repo.huaweicloud.com/repository/php/；旧地址mirrors.huaweicloud.com已失效，需用正确命令composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/全局配置。
怎么确认当前用的是不是华为云镜像
执行 composer config -g -l，在输出里找 repos.packagist 这一项。如果值是 https://repo.huaweicloud.com/repository/php/，说明已生效；如果是 https://packagist.org 或空，就还没切过去。
注意：有些旧教程写的是 https://mirrors.huaweicloud.com/repository/php/（多了一个 mirrors.），这个地址已失效，会报 Could not resolve host 或 404，必须用官方当前维护的地址。
全局切换到华为云镜像的正确命令
运行这一条就够了：
composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/
这条命令会直接写入全局配置文件 ~/.composer/config.json，之后所有项目都走华为云源。不需要加 --unset、不用改 secure-http，也不用提前清缓存——Composer 会在下次 install/update 时自动识别新源。
- 如果提示
Permission denied，说明~/.composer/目录权限异常，可临时加sudo（不推荐）或修复目录属主：chown -R $USER:$USER ~/.composer - 华为云镜像同步延迟极低（官方标注“实时同步”），比部分高校镜像更稳定，尤其适合 Laravel、Symfony 等大包场景
- 别手误写成
repos.packagist.org或漏掉末尾斜杠 ——https://repo.huaweicloud.com/repository/php（少斜杠）也会 404
只想当前项目用华为云镜像？别动全局配置
进项目根目录，执行：
composer config repo.packagist composer https://repo.huaweicloud.com/repository/php/
这会在当前项目的 composer.json 里自动加一段 repositories 配置，只影响这个项目。适合团队协作中避免强制统一源，或测试不同镜像表现。
如果后续想删掉它，别手动编辑 composer.json，直接运行：
composer config --unset repos.packagist
否则容易格式错乱或留残缺字段，导致 composer validate 报错。
切完镜像后装包还是慢或失败？先看这几处
华为云镜像本身没问题，但常见卡点在本地环境：
-
composer clear-cache必须执行一次——旧缓存可能还指向 packagist.org 的元数据，不清理会导致部分包重定向失败 - 检查是否开了代理：某些公司网络会拦截 HTTPS 请求，表现为
SSL certificate problem，此时需临时关代理，或加composer config -g secure-http false（仅调试用，勿长期开启） - 若用 Docker，宿主机换了镜像，容器内 Composer 仍用默认源——得在
Dockerfile或构建脚本里显式执行配置命令 - 华为云镜像不支持私有包托管，如果你的
composer.json里写了自建私有源，repositories数组顺序很重要：packagist 必须放在最后，否则会跳过私有源查找
镜像只是加速通道，不是万能解药；真正卡住的时候，往往不是源的问题，而是缓存、网络策略或配置叠加冲突。
