华为云镜像源需用composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/配置，注意字段名无s、路径完整且必须https，企业网络下更稳，ci/cd在华为云环境可内网加速。
直接用这条命令，华为云镜像源就能生效： composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/
为什么选华为云镜像？不是所有“国内源”都一样快
阿里云、腾讯云、华为云三者中，华为云镜像在企业级网络（尤其政企、教育网、部分IDC）稳定性更强，同步延迟通常控制在15分钟内；但对家庭宽带用户，有时反而不如阿里云或中科大源快。它真正的优势是 HTTPS 证书合规性好、不拦截私有包重定向、支持 IPv6 双栈——如果你的 CI/CD 环境跑在华为云 ECS 或用了华为云 DevCloud，镜像会自动走内网加速。
配置命令必须带 repo.packagist，不是 repos.packagist
这是高频出错点：旧文档或博客常写错成 repos.packagist（多一个 s），导致配置无效却无报错。正确字段名是 repo.packagist，它对应 Composer 内部的「主包仓库」标识符，硬编码在 src/Composer/Config.php 里。
- ✅ 正确：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/ - ❌ 错误：
composer config -g repos.packagist composer ...（会被忽略） - 验证是否生效：
composer config -g --list | grep repo.packagist，应输出完整 URL
项目级临时切换：改 composer.json 比全局更安全
团队协作或混合环境（比如本地开发用阿里云，测试服务器用华为云）时，全局配置反而容易引发不一致。推荐直接在项目根目录 composer.json 中加 repositories 块：
{
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.huaweicloud.com/repository/php/composer/"
}
}
}
注意两点：
- 这个
packagist是 key 名，不能改成huawei或其他——Composer 强制识别该 key 为默认源覆盖 - 一旦写了这个配置，
composer install就不会读全局repo.packagist，优先级更高 - 提交到 Git 时保留它，避免队友因源不同导致
composer.lock生成差异
华为云镜像地址末尾的路径细节容易被忽略：/repository/php/composer/ ≠ /composer/，少一级就会 404；另外它不支持 http://，必须用 https://，否则 secure-http 默认 true 会拒绝连接。
