全局镜像配置唯一有效方式是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，仅此命令覆盖元数据源；repositories数组不影响官方包请求，且需配合parallel-downloads 15提升下载效率。
composer config -g repo.packagist 是唯一生效的镜像配置点
改 repositories 数组完全不影响官方包的元数据请求——Composer 3.x+ 把 Packagist 元数据源硬编码为 https://repo.packagist.org，repositories 只管私有源。真正覆盖元数据路由的，只有这一条命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
常见错误包括：
- 漏掉
-g，导致只在当前项目生效，换目录就回退到官方源 - 手写
~/.composer/config.json，格式错、缩进乱、意外覆盖auth字段 - 项目级配置和全局配置冲突：若
composer.json里也声明了packagist类型源，项目配置优先生效
验证是否生效：composer config repo.packagist 应输出 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；再执行 composer show packagist/support，URL 字段必须含镜像域名。
镜像不是实时同步，而是 Sync-on-request 按需触发
所谓“同步”，是指镜像站收到对某个 p2/vendor/name/version.json 或 p/provider-vendor~x.y.json 的首次请求时，若本地无缓存，才反向拉取官方源对应文件并缓存。这导致：
- 新发布的包（尤其是刚打
git tag v1.0.0但 Packagist 尚未更新）首波请求大概率 404 -
packages.json里列出的provider-includes映射是分片的，镜像可能只同步了部分区间（如provider-laravel~9.0.json有了，provider-laravel~10.0.json还没生成） -
composer diagnose报Could not fetch packages.json，往往不是网络问题，而是该 provider 文件还没被镜像拉取
验证方式：curl -I https://mirrors.aliyun.com/composer/p2/laravel/framework/10.0.0.json 看是否返回 200；再比对官方源 curl -I https://repo.packagist.org/p2/laravel/framework/10.0.0.json。若官方有、镜像无，说明未同步，可临时切中科大源：composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/。
composer update 不是增量操作，镜像只加速元数据获取
composer update 默认丢弃 composer.lock 并全量重跑依赖求解器，跟镜像无关。镜像只影响“找包信息”这一步的速度和成功率，比如请求 https://mirrors.aliyun.com/composer/p2/laravel/framework/10.0.0.json 而非直连官方源。
容易踩的坑：
-
composer update laravel/framework是安全的局部更新；加--with-all-dependencies等价于全量重算，不是“更深”，而是更慢、更易漂移 - 镜像同步滞后时，
composer update laravel/framework:10.0.0仍会失败——因为镜像还没生成对应的provider-laravel~10.0.json或p2/...文件 -
composer clear-cache只清下载缓存（zip/tar），不删元数据缓存；要逼 Composer 重拉索引，得手动删掉~/.composer/cache/repo/https---mirrors.aliyun.com-composer/
真正控制变更范围的唯一方式，就是显式指定包名，且不带扩大作用域的参数。其他所有“加速”或“智能更新”的预期，都建立在元数据已就绪的前提下。
并发下载数默认 5 太保守，调到 15 才压满带宽
Composer 2.2+ 默认启用并行下载，但并发数仅设为 5，对国内多节点镜像（阿里云、腾讯云、中科大）来说严重浪费带宽。实测调至 15 后，整体安装耗时下降 40%～60%，又不会触发镜像限流。
操作很简单：
- 查当前值：
composer config -g parallel-downloads - 设为 15：
composer config -g parallel-downloads 15 - 别设到 20+，否则 DNS 解析可能超时，报
Failed to decode response或Connection refused
这个参数和镜像配置一样，必须用 -g 全局设置，否则单个项目里改了也没用——因为元数据请求本身卡在 provider 分片加载上，下载并发再高也得等索引先回来。
