镜像源对“Resolving dependencies”阶段完全无效，该阶段由本地SAT求解器执行暴力回溯，与网络无关；卡顿主因是宽泛PHP版本约束、dev分支引入、require-dev冲突或composer.lock缺失，需收紧约束、删非核心dev依赖或加--no-dev等参数优化。
镜像源对“Resolving dependencies”阶段完全无效
换完清华源、阿里云源之后，composer install 还卡在 Resolving dependencies 十几秒甚至更久？这不是镜像没生效，而是你误判了瓶颈位置。镜像只加速元数据（packages.json、provider-xxx.json）下载和 ZIP 包拉取，**不参与、也不影响依赖解析过程**。这个阶段纯靠本地 CPU 和内存做 SAT 求解，和网络无关。
常见诱因包括：
-
"php": "*"或"^7.4 || ^8.0 || ^8.1 || ^8.2"这类宽泛约束，让求解器暴力尝试数百种组合 -
"minimum-stability": "dev"强制纳入大量不稳定版本，候选包数量指数级增长 -
composer.lock被删或未提交，install实际退化为update，触发全量解析 - 项目
composer.json中repositories字段指向已下线私有源，Composer 逐个超时后才 fallback
验证方式：运行 composer config --list | grep repositories，确认实际生效的源；再跑 composer validate --strict 检查 lock 文件完整性。
大型项目真正要加的四个关键参数
光换镜像，最多把下载从 3 分钟压到 20 秒；但大型项目（vendor 超 300 包、lock 文件 >5MB）的耗时大头在 PHP 解析、文件写入和 autoload 初始化。必须配合这四个参数：
-
--no-dev：跳过require-dev安装（省掉 30–60% 时间），但注意——它不跳过 dev 依赖的解析，只是不写进 vendor -
--prefer-dist：强制走 ZIP 包，绕过 git clone 的 I/O 和网络开销（实测比 source 快 2–5 倍） -
--optimize-autoloader（或-o）：把 PSR-4 映射转成 classmap，避免运行时遍历目录；PHP 7.4+ 下进 opcache 效果明显 -
--classmap-authoritative（或-a）：仅限部署环境，告诉 autoloader “不在 classmap 里 = 真没有”，彻底跳过文件扫描（本地开发禁用，否则新增类直接Class not found）
CI/CD 推荐组合：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。
为什么你配了镜像却还是慢？三个静默失效点
90% 的“换源无效”问题，不是镜像本身不行，而是配置命令写错，且 Composer 不报错、只静默 fallback 回 packagist.org：
- 键名必须是
repo.packagist，写成repos.packagist（多一个 s）就彻底失效 - 命令中必须显式传入
composer作为 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间那个composer就白配 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（缺斜杠会导致路径拼成/p2//，404 后自动回退）
验证是否生效，只认这一条命令输出：composer config -g repo.packagist，结果必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或还是 https://packagist.org，说明根本没写进去。
项目级配置会直接覆盖全局镜像
如果你在项目 composer.json 里写了 repositories 字段（哪怕只有一行），全局配置的 repo.packagist 就会被无视。这是 Composer 2.2+ 的默认行为：它优先读取项目级 repositories，只有当里面没定义 packagist 条目时，才 fallback 到全局 repo.packagist。
团队协作时尤其危险——有人本地手动加了 "repositories": [{"type": "composer", "url": "https://packagist.org"}]，一提交，整个 CI 就开始走海外源。正确做法是：
- 已有私有源？手动编辑
composer.json，在repositories里加一条"packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } - 同时在根节点加
"packagist.org": false（注意：不是放在repositories里，是同级字段） - 避免用
composer config repo.packagist ...（不加-g）去覆盖，它会清空你已有的私有源配置
同步延迟和缓存路径这些细节，反而容易被忽略——比如华为云镜像新包有 5–30 分钟延迟，阿里云通常 1–3 分钟；而 ~/.composer/cache/files 不可写，镜像再快也得重下 ZIP。
