Composer 配镜像需严格遵循三要点：字段名 repo.packagist（非 repos）、type 值为 composer、URL 以 https:// 开头且末尾带 /；并发下载需 Composer 2.2+ 并设 parallel-downloads；--prefer-dist 必须配合镜像才提速，且需清缓存、删 vendor 和 lock 文件后重装。
composer config -g repo.packagist 命令必须写对三个关键点
配镜像不是“运行了命令就完事”，90% 的失败源于字段名、type 值或 URL 格式写错，且 Composer 不报错，而是静默 fallback 到 packagist.org。
-
repo.packagist不能写成repos.packagist（多一个s就失效） - 第二个参数必须是
composer（这是仓库类型声明，漏掉会导致走默认源） - URL 必须以
https://开头，且末尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出 404 路径）
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 JSON，例如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没写进去。
parallel-downloads 只在 Composer 2.2+ 生效且需手动启用
并发下载不是默认开启的——默认值是 3，基本等于串行。不设高，composer install 就卡在 Downloading 阶段不动。
- 先确认版本：
composer --version，输出必须是2.2.x或更高；旧版需先升级：composer self-update --prefer-dist - 全局设并发数：
composer config -g parallel-downloads 10（10 是多数开发机的安全上限） - 若出现
file_put_contents(/tmp/): failed to open stream，说明并发太高触发临时文件竞争，降到6或8再试
注意：parallel-downloads 对 composer update 加速有限，它主要优化 install 阶段的包拉取。
立即学习“PHP免费学习笔记（深入）”；
--prefer-dist 必须和镜像源配合才真正提速
国内镜像几乎不缓存 source（Git 仓库），只缓存 dist（预打包 ZIP/TAR）。不加 --prefer-dist，Composer 会 fallback 到慢速 Git clone，再高的并发也白搭。
- CI/CD 中必须显式加：
composer install --prefer-dist --no-dev --optimize-autoloader - 全局设默认：
composer config -g prefer-dist true（开发机慎用，会干扰你直接改vendor/里的源码） - 如果项目
composer.json里写了"prefer-source": true，它会覆盖全局设置，必须手动删掉 - 私有包只提供
source地址时，--prefer-dist会直接失败，报错类似Could not find a matching version of package xxx
换镜像后仍慢？先清缓存再重装
镜像只加速下载，但本地缓存可能还残留 packagist.org 的元数据，导致请求路径、哈希校验全错位。
- 执行
composer clear-cache清掉旧缓存 - 删掉
vendor/和composer.lock - 再跑
composer install—— 让 Composer 从新镜像重新拉取元数据并生成新 lock 文件 - 别试图保留旧
composer.lock：它记录的是旧源的包哈希，和新镜像返回的数据不兼容
最容易被忽略的是宝塔面板或 CI 容器里用户权限不一致：全局配置写在 root 用户下，但宝塔用 www 用户执行，结果配置根本没加载。验证前先切到实际执行用户，再跑 composer config -g repo.packagist。
