Composer全局镜像配置不生效，主因是项目级repositories覆盖或URL缺结尾斜杠；优先级为项目配置＞全局配置＞默认源，且必须以/结尾、及时清缓存并用composer diagnose验证。
全局镜像配置不生效，大概率不是命令写错了，而是被项目级 repositories 覆盖了，或者镜像 URL 少了个结尾斜杠。
composer config -g repo.packagist 命令为什么有时不生效
这条命令本身没问题，但 Composer 的源优先级是：项目级 composer.json 中的 repositories > 全局配置 > 默认源。只要项目根目录下 composer.json 里写了 "repositories": {...}，哪怕只有一行空对象，全局设置就完全失效。
- 执行
composer config --list（在项目目录下）看是否输出repositories相关字段 - 检查
composer.json是否含"repositories"键；有则删掉或改用{"packagist": false}显式禁用默认源再加镜像 - CI/CD 环境中避免用
sudo composer config -g，否则写进的是 root 用户的~/.composer/config.json，而构建进程可能以普通用户运行
URL 必须以 / 结尾，否则请求会 404
镜像地址拼接逻辑是硬编码的：https://mirrors.aliyun.com/composer/ + packages.json。如果少写末尾斜杠，就会变成 https://mirrors.aliyun.com/composerpackages.json，直接 404。
- 正确写法：
https://mirrors.aliyun.com/composer/✅ - 错误写法：
https://mirrors.aliyun.com/composer❌ - 其他可用镜像（均需带结尾斜杠）：
https://mirrors.cloud.tencent.com/composer/、https://mirrors.huaweicloud.com/composer/
验证镜像是否真在用，别只看命令返回
执行 composer diagnose，关注输出中 Repo packagist.org: 后面的地址是不是你设的镜像域名。更直接的方式是加 -vvv 跑一次安装：composer install -vvv 2>&1 | grep -i "mirrors\|packagist"，确认实际发起请求的 host 是镜像站。
立即学习“PHP免费学习笔记（深入）”；
- 如果看到
Could not fetch https://mirrors.xxx.com/p2/...，说明已走镜像，但服务暂时不可用 - 如果看到
Could not fetch https://packagist.org/packages.json，说明根本没切过去 - Docker 构建时，
composer config -g写的配置不会持久化，必须在RUN指令中显式执行，或直接写进composer.json的repositories
多个镜像怎么配才不白配
Composer 不自动 fallback，它只按 repositories 数组顺序查，第一个返回非 200 就报错，不会继续往后试。
- 想用阿里云 + 官方兜底，得手动写全：
{"repositories": [{"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}, {"packagist.org": false}]} - 别指望“自动选最快”，也别把两个 HTTPS 镜像并列放——第一个超时或证书错误，第二个根本不会触发
- 私有 VCS 包（如 GitLab 私库）不受
repo.packagist影响，它们走自己定义的vcs类型仓库，镜像只作用于 Packagist 默认源
最常被忽略的一点：改完镜像后不清理缓存，旧包信息仍可能从本地 ~/.composer/cache 加载，导致行为和预期不符；遇到异常先跑 composer clear-cache 再重试。
