生效的华为云镜像地址必须是 https://repo.huaweicloud.com/repository/php/；错误示例包括 https://packagist.org、空值、https://mirrors.huaweicloud.com/repository/php/（已404）或缺少末尾斜杠；正确配置命令为 composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/。
确认当前镜像是否已切到华为云
执行 composer config -g repo.packagist，输出必须是 https://repo.huaweicloud.com/repository/php/ 才算生效。如果显示 https://packagist.org、空值，或带 mirrors.huaweicloud.com（多了一个 mirrors.），说明没切对或用了失效地址。
- 旧教程里常见的
https://mirrors.huaweicloud.com/repository/php/已 404，必须用官方当前维护的地址 - 少一个末尾斜杠 —— 比如写成
https://repo.huaweicloud.com/repository/php，也会因路径拼接错误导致 404 -
repos.packagist（带 s）是错的字段名，Composer 完全忽略它，但不报错，极易误以为“配置成功”
全局切换华为云镜像的正确命令
只运行这一条就够了：composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/。它会直接写入 ~/.composer/config.json，之后所有项目默认走这个源。
- 不需要加
--unset，不用手动改secure-http，也不用提前clear-cache—— Composer 在下次install或update时自动识别新源 - 如果提示
Permission denied，大概率是~/.composer/目录权限错乱，修复命令：chown -R $USER:$USER ~/.composer（比加sudo安全） - 华为云镜像同步延迟极低（官方标注“实时同步”），尤其适合 Laravel、Symfony 等依赖多、包体大的项目
只想当前项目用华为云？别动全局配置
进项目根目录，运行：composer config repo.packagist composer https://repo.huaweicloud.com/repository/php/。这条命令会在当前项目的 composer.json 里自动加 "repositories" 块，只影响这个项目。
- 优先级高于全局配置，适合团队协作中避免强制统一源，或测试不同镜像表现
- 后续想删掉它，别手动编辑
composer.json，直接运行：composer config --unset repos.packagist，否则容易格式错乱或留残缺字段，导致composer validate报错 - 注意：项目级配置里的 key 必须是
packagist（不能改成huawei或其他），否则 Composer 不识别为默认源覆盖
切完还是慢或失败？先排查这三处
华为云镜像本身稳定，但卡点往往在本地环境：
- 检查项目根目录
composer.json是否硬编码了"repositories": {"packagist": {"url": "https://packagist.org"}}—— 这种项目级配置会屏蔽全局设置，优先级更高 - 确认没漏掉
composer clear-cache。虽然换源后 Composer 会自动拉新元数据，但旧缓存可能干扰首次install的行为 - 企业网络或 CI/CD 环境下，若服务器部署在华为云 ECS，镜像会自动走内网加速；但家庭宽带用户有时反而不如阿里云快，这不是配置问题，而是网络拓扑差异
最容易被忽略的是：镜像地址必须是 https 协议，且末尾斜杠不能少，字段名是 repo.packagist（不是 repos），这三点错任意一个，都静默失效。
