composer国内镜像切换需严格使用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/命令，缺一不可：-g表示全局、键名必须为单数小写repo.packagist、type值必须显式写composer、url须https且末尾带/，否则静默失效；配置后应执行composer clear-cache并用composer config -g repo.packagist验证输出完整json对象。
国内直接用官方 Composer 源，composer install 经常卡在 Downloading... 或报 Connection timeout —— 不是网络问题，是源服务器物理距离太远、TLS 握手慢、甚至被间歇性干扰。换国内镜像能立竿见影提速，但不是所有镜像都可靠，也不是换完就万事大吉。
怎么临时切换镜像（适合 CI/CD 或单次调试）
不用改全局配置，命令行加 -vvv 可看实际请求地址，验证是否生效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：repo.packagist 是 Composer 2.2+ 的写法；旧版本（如 1.x）要用 packagist（无 repo. 前缀），否则配置不生效。阿里云、腾讯云、华为云镜像都支持 HTTPS，但部分高校镜像（如清华）已停用 HTTP 镜像源，强制用 HTTPS。
为什么 composer update 还是走国外源？
常见原因是项目根目录存在 composer.json 里硬编码了源：
"repositories": [
{
"type": "composer",
"url": "https://packagist.org"
}
]
这种写法会覆盖全局镜像配置。解决办法只有两个：
- 删掉
repositories字段（推荐，让全局镜像生效） - 把
url改成对应镜像地址，例如"url": "https://mirrors.aliyun.com/composer/"
特别注意：某些私有包仓库（如企业 Nexus）如果和公共镜像混用，必须保留 repositories，此时需显式声明 "packagist": false，再单独加镜像源，否则 Composer 会跳过镜像直连 packagist.org。
镜像同步延迟与缓存一致性问题
国内主流镜像（阿里、腾讯）通常 5–15 分钟同步一次 packagist.org，新发布的包可能查不到。遇到 Package xxx not found 但确认已发布，先检查：
- 该包是否设为
abandoned或仅限特定stability（如dev） - 执行
composer clear-cache清掉本地元数据缓存 - 临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org
不要长期依赖“最新包”，生产环境应锁死 composer.lock，镜像延迟对已有依赖无影响。
最易被忽略的点：Docker 构建时，composer install 在容器内执行，宿主机的全局镜像配置无效——必须在 Dockerfile 中显式配置，或 COPY 已配置好的 ~/.composer/config.json 进镜像。
