换镜像源是必须第一步，否则优化收效甚微；常见失效原因是键名拼错（如repos.packagist少s）、旧版不支持、权限不足或未清缓存；项目级repositories会覆盖全局配置；parallel-downloads仅对install有效；SAT求解卡顿主因是依赖约束过宽。
换镜像源不是“试试看”的可选项，是必须做的第一步；不换源，其他所有优化都收效甚微。
composer config -g repo.packagist 命令为什么总不生效
最常见原因是键名拼错：写成 repo.packagist（正确）和误写为 repos.packagist（少一个 s），后者在 Composer 2.x 中会被完全忽略，配置看似执行成功，实则没写进 ~/.composer/config.json。
- 验证是否真生效：运行
composer config -g repo.packagist，输出应为完整 URL 字符串或 JSON 对象，空值或https://packagist.org表示失败 - 旧版 Composer 1.x 不支持该语法，需改用
composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}' - 权限问题可能导致写入失败，尤其在 WSL 或 Docker 容器中，检查
~/.composer/目录是否可写 - 配置后必须执行
composer clear-cache，否则旧元数据仍会触发对官方源的请求
为什么换了镜像，-vvv 日志里还在请求 packagist.org
Composer 并非简单“全局换源”，它有一套优先级规则：项目级 repositories > 临时 --repository > 全局 repo.packagist。只要项目根目录的 composer.json 里存在 "repositories" 字段（哪怕只是空数组），就会跳过全局镜像。
- 检查项目
composer.json是否含"repositories"；若有，确认其中是否显式包含"packagist.org": false，否则 Composer 会 fallback 回默认源 - 私有包、
path类型仓库、废弃包（abandoned）也会绕过镜像，直接回源拉取元数据 - 镜像同步有延迟（通常 5–30 分钟），新发布的包可能尚未同步，
composer show vendor/package -vvv可观察真实请求域名 - 公司内网代理或 DNS 缓存可能干扰解析，用
curl -I https://mirrors.aliyun.com/composer/packages.json直接测试连通性
parallel-downloads 和 --prefer-dist 怎么配才真正提速
parallel-downloads 是 Composer 2.2+ 原生并发机制，但它只对 composer install 有效，对 composer update 几乎无加速作用——因为依赖图求解（SAT）本身是串行的。
- 全局启用：运行
composer config -g parallel-downloads 10；设为 20 容易触发file_put_contents(/tmp/): failed to open stream，8～10 是更稳妥的上限 -
--prefer-dist强制下载预打包 ZIP，跳过 Git clone 和源码编译，但仅当包提供dist地址时才生效；某些私有包或 dev 分支可能只有source，此时该参数被忽略 - 生产部署必加组合：
composer install --no-dev --prefer-dist --optimize-autoloader；开发阶段慎用--classmap-authoritative，它会让每次update都重扫整个vendor目录
Resolving dependencies 卡住不动，和镜像无关
如果日志停在 Resolving dependencies through SAT 超过 2 分钟，问题不在网络，而在依赖约束本身。Composer 的 SAT 求解器会暴力尝试所有版本组合，宽泛约束（如 "php": ">=7.4" 或 "monolog/monolog": "^1.0 || ^2.0"）极易导致指数级计算爆炸。
- 缩小 PHP 版本范围：
"php": "^8.1"比">=7.4"少查数百个包的兼容性元数据 - 避免全量更新：
composer update monolog/monolog比composer update快得多 - CI 场景可临时绕过校验：
composer update --with-all-dependencies，但不推荐日常使用 - Xdebug 会拖慢 SAT 计算 5–10 倍，调试时临时禁用：
php -d xdebug.mode=off $(which composer) update
镜像配置只是起点，真正卡点往往藏在 composer.json 的约束写法、本地缓存状态、甚至 PHP 扩展加载顺序里；跑一次 composer diagnose 和 -vvv 日志，比反复换源更管用。
