真正生效需用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 设置，避免手写 config.json；配置可能被项目级 repositories 覆盖，且镜像服务需可用。
composer全局镜像怎么设才真正生效
直接改 ~/.composer/config.json 不一定管用——Composer 会优先读取当前项目根目录下的 composer.json 或 composer.lock 中的 repositories 配置，覆盖全局设置。真正生效的前提是：全局配置没被项目级配置绕过，且镜像地址本身可用。
- 必须用
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（阿里云）或https://packagist.phpcomposer.com（已停用，别踩坑） - 别手写
config.json，容易格式错、路径错、权限错；composer config -g自动处理路径和 JSON 格式 - 执行后检查是否写入成功：
composer config -g --list | grep repo，确认输出里有你设的 URL - 如果公司内网或 CI 环境，注意 DNS 和 HTTPS 证书：有些镜像（如腾讯云
https://mirrors.cloud.tencent.com/composer/）要求系统信任其 CA
为什么换了镜像还是慢或报错
常见现象是 composer install 卡在 “Loading composer repositories”，或者报 Could not fetch https://mirrors.xxx.com/packages.json —— 这不是配置没生效，而是镜像服务本身响应异常或协议不匹配。
- 优先选 HTTPS 镜像，但某些老旧 PHP 版本（如 7.0 以下）可能不支持 SNI，得换 HTTP（如
http://packagist.phpcomposer.com，仅限测试环境） - 阿里云、华为云镜像偶尔会同步延迟，导致新包找不到；可临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org - 某些私有包（比如 GitLab 私库）不受全局镜像影响，它们走的是自己定义的
vcs类型仓库，镜像只作用于 Packagist 默认源
CI/CD 或 Docker 构建时镜像失效怎么办
Docker 容器默认没有用户家目录，composer config -g 写的配置不会持久化，每次 composer install 都走默认源。
- 构建阶段显式设置：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，放在composer install前 - 更稳妥的做法是写进
composer.json的repositories字段（虽然不算“全局”，但能确保项目构建一致） - GitHub Actions 等平台要注意缓存：如果缓存了
vendor/但没缓存 Composer 配置，下次拉取可能仍走慢源；建议缓存~/.composer目录
如何验证当前实际使用的源
别猜，直接看 Composer 自己读的是哪个地址。最准的方式不是查配置文件，而是让 Composer 输出它正在请求的 URL。
- 加
-v参数触发详细日志：composer show -v | head -10，找Reading composer.json from和Loading config file行 - 或者强制触发一次元数据加载：
composer clear-cache && composer diagnose -v 2>&1 | grep "Fetching"，能看到真实请求的 URL - 注意区分
packagist.org和packagist.phpcomposer.com：后者已下线多年，若看到这个域名，说明配置残留或脚本硬编码，必须清理
composer.json 的 repositories 字段会直接屏蔽全局配置，这点最容易被忽略。 
