推荐使用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 一键配置全局镜像，该命令自动适配平台、安全写入、保留原有配置；手动修改 ~/.composer/config.json 易因 JSON 格式错误导致全局限令失败。
Composer 全局镜像配置本质是修改 composer.json 的 repositories 配置，但直接改全局文件不推荐；真正稳定、可复用的一键方案是使用 composer config 命令操作 COMPOSER_HOME 下的全局配置文件。
为什么不能直接改 ~/.composer/config.json？
手动编辑容易出错，尤其 JSON 格式缩进或逗号遗漏会导致后续所有 composer 命令报错（如 file_get_contents(): Failed to open stream）；且不同系统 COMPOSER_HOME 路径不同（Windows 是 %APPDATA%\Composer），硬编码路径不可靠。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/是唯一推荐的写法 - 该命令自动识别平台，安全写入全局配置，同时保留原有配置项（如 auth tokens）
- 执行后无需 reload 或重启终端，下一次
composer require就生效
阿里云、腾讯云、华为云镜像地址及验证方式
国内主流镜像源均已支持 HTTPS + Packagist 协议兼容，但必须用完整 URL，不能漏掉末尾 /（否则会 404）：
- 阿里云：
https://mirrors.aliyun.com/composer/（最稳定，响应快） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（部分地区偶发 DNS 解析慢） - 华为云：
https://repo.huaweicloud.com/repository/php/（注意路径不是/composer/）
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 URL；再执行 composer show packagist/support，看请求 URL 是否走镜像域名。
如何临时切回官方源或禁用镜像？
全局镜像不是“开关”，而是显式声明了一个 Packagist 类型仓库。要还原，有且仅有两种干净方式：
