最常见原因是URL末尾缺/，导致Composer 2.2+静默回退官方源；验证需用composer config -g repo.packagist，输出必须为含末尾斜杠的完整JSON，如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 配置后为什么没提速？
最常见原因是 URL 末尾缺了 /。比如写成 https://mirrors.aliyun.com/composer（少斜杠）会导致 Composer 2.2+ 版本静默 fallback 到官方源，composer install 依然慢，但 composer diagnose 可能不报错，也看不出异常。
验证方式必须用：composer config -g repo.packagist，输出应为完整 JSON，且 url 字段值末尾有且仅有一个 /，例如：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
- 漏掉斜杠 → 请求
packages.json时返回 404 或空响应 → 自动退回到packagist.org - 配置写入的是当前用户目录（
~/.composer/config.json），但在宝塔、Jenkins 或 systemd 服务中，执行命令的可能是www或jenkins用户，需切换对应用户再执行配置 - 项目根目录已有
composer.json中定义了repositories，会直接覆盖全局配置，此时composer config -g生效但实际不走镜像
如何测出真实镜像读取速度？
不能只看 composer install 总耗时——它混杂了依赖解析、解压、自动加载器生成等环节。真正反映镜像质量的是元数据拉取阶段：即下载 packages.json 和各包 dist ZIP 的首字节延迟与吞吐。
推荐用 -vvv 开关观察实际请求域名：
composer require monolog/monolog -vvv 2>&1 | grep "GET "
你会看到类似：
GET https://mirrors.aliyun.com/composer/p2/monolog/monolog.json
若出现 packagist.org 或 api.github.com，说明该包未被镜像覆盖或同步延迟。
- 首次运行
composer install慢，是因要重建本地缓存索引，不是镜像问题；后续再执行才体现真实差异 - 测试应选含 50+ 依赖的中型项目（如 Laravel 10 + guzzle + doctrine），避免小项目误差过大
- 用
time curl -I https://mirrors.aliyun.com/composer/packages.json可单独测元数据响应时间，time curl -o /dev/null https://mirrors.aliyun.com/composer/p2/laravel/framework.json测单包元数据获取耗时
项目级配置 vs 全局配置：哪个更适合 CI/CD？
CI/CD 场景下，项目级配置更可控，尤其当项目依赖私有仓库时。但要注意：composer config repo.packagist 是全量替换 composer.json 中的 repositories 字段，不是追加。
错误做法：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
如果原 composer.json 已有私有源，这条命令会清空整个 repositories，只剩阿里云镜像，导致私有包无法安装。
- 正确保留私有源的方式：手动编辑
composer.json，在repositories中显式添加 packagist 镜像，并设"packagist.org": false在根节点 - CI 脚本中建议优先用环境变量
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/，它优先级高于全局和项目配置，且不污染代码 - 全局配置在 Docker 构建中可能失效——因为构建时用户是
root，而配置写在非 root 用户家目录下
为什么有些包还是从 packagist.org 下载？
镜像不是万能代理，以下情况必然绕过镜像：
- 包作者在
composer.json中声明了repositories（如指向 GitHub Git 仓库），Composer 会直接拉取源码而非走镜像 dist - 使用
path类型仓库（如"mylib": {"type": "path", "url": "../mylib"}）完全不经过网络 - 新发布的包尚未同步到镜像站（主流镜像同步延迟约 5–30 分钟）
- 包被标记为
abandoned，Composer 会尝试回源拉取原始信息做兼容处理
可通过 composer show vendor/package -vvv 查看具体请求路径；若发现大量包仍走 packagist.org，大概率是项目自身 composer.json 定义了非标准仓库，此时换镜像源无意义。
