应执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局切换，需严格满足-g、repo.packagist（单数）、composer类型值及url末尾斜杠四要素，缺一即静默失效。
如何用命令行一键切换 Composer 镜像
国内直接用官方源 packagist.org 通常超时或卡死，最稳妥的改法是用 composer config 命令全局或项目级修改镜像地址，不碰 JSON 手动编辑，避免格式错误。
执行以下任一命令即可生效：
- 全局切换为阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 仅当前项目切换（推荐测试时用）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 恢复官方源：
composer config -g --unset repos.packagist
为什么不能直接改 composer.json 里的 repositories
很多人在项目 composer.json 中手动加 repositories 字段，结果发现 require 不生效或报 Could not find package 错误——因为 Composer 默认只信任官方源，除非显式禁用 packagist.org 或设为 packagist: false，否则自定义 repositories 不会覆盖默认行为。
真正起作用的是 repo.packagist 这个特殊配置项，它专用于替换默认 packagist 源，且优先级高于 repositories 列表。
composer config 的常见坑点
几个容易导致失败的操作：
- 漏掉
composer协议前缀：写成https://mirrors.aliyun.com/composer（少斜杠）或http://...（非 HTTPS）都会被拒绝 - 混淆
-g和--global：两者等价，但-g更常用；没加-g就是改当前项目，别误以为改了全局 - Windows 下 PowerShell 可能对
$符号转义异常，建议用 CMD 或 Git Bash 执行 - 改完不验证：运行
composer config -g repo.packagist确认输出是否为预期 URL
镜像地址选哪个？稳定性和兼容性差异
目前主流镜像中：
- 阿里云
https://mirrors.aliyun.com/composer/同步及时，支持 HTTPS，适合绝大多数场景 - 腾讯云
https://mirrors.cloud.tencent.com/composer/延迟略高，偶有同步滞后 - 华为云已下线 Composer 镜像服务，
https://mirrors.huaweicloud.com/composer/返回 404 - 清华源已停止维护 Composer 镜像，旧文档链接不可用
如果遇到 Repository not found 或 SSL certificate problem，优先检查 URL 是否拼错、是否用了已停服的地址，而不是怀疑网络或证书配置。
