Composer 安装 composer/installers 慢主因是未正确配置国内镜像源，需严格使用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意无s、带type、HTTPS且末尾有斜杠），并清缓存、验证JSON输出、避免宽泛约束与xdebug干扰。
Composer 安装 composer/installers 慢，基本不是包本身的问题，而是整个依赖解析和下载链路没对齐国内镜像——尤其当你用的是旧版 Composer、或项目里混了私有源时，composer/installers 这个基础插件反而最容易卡住。
composer config -g repo.packagist 命令必须写对三处硬性位置
90% 的“加速失败”其实根本没换源，命令静默失效但不报错：
-
repo.packagist不能写成repos.packagist（多一个s就彻底忽略） - 必须带
composer作为 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/——漏掉composer就 fallback 到官方源 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（少斜杠会拼出/packages.json导致 404）
验证是否生效：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null、或仍是 https://packagist.org 都说明没写进去。
composer install --prefer-dist 卡在 downloading？先清缓存再试
composer/installers 是 dist 包（ZIP），但旧缓存里可能还存着 packagist.org 的元数据，Composer 会优先读缓存并尝试从海外地址拉校验信息，结果卡在 DNS 或 TLS 握手。
- 必须执行
composer clear-cache，否则换源无效 - 确认项目级
composer.json里没有"prefer-source": true，它会覆盖全局--prefer-dist - 如果用了宝塔、CI 或计划任务，注意执行用户（如
www）和配置用户（如root）不一致：切到对应用户下重配，例如sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Resolving dependencies 卡住几十秒？和镜像完全无关
这个阶段不走网络，纯本地穷举版本组合。composer/installers 虽小，但若你项目里写了宽泛约束（如 "php": "^7.4 || ^8.0"）、或 require-dev 里堆了十几个未锁定的工具包，Composer 就会反复回溯，指数级爆炸。
- 删掉
vendor和composer.lock后跑composer install -vvv，观察日志最卡的位置：如果是Resolving dependencies，立刻收起换源思路 - 收紧 PHP 版本约束：
"platform": {"php": "8.1"}写进config段，避免跨大版本试探 - 禁用
xdebug：CLI 模式下它会让 Composer 自身代码反复编译，实测拖慢 3–5 倍 - 删掉不必要的
require-dev包，或用--no-dev跳过它们
项目里已有 repositories 字段？别手动编辑，用命令追加
很多项目已定义私有仓库（比如内部组件源），手动改 composer.json 极易破坏结构，导致 composer/installers 找不到基础包。
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 这条命令会自动识别现有
repositories类型（对象 or 数组），并在末尾安全追加 packagist 条目，不覆盖原有私有源 - 改完后务必跑一次
composer update --lock，让composer.lock记录新源地址，否则下次 install 仍可能 fallback
真正容易被跳过的点：换源只加速元数据拉取和 ZIP 下载，composer/installers 的安装逻辑本身不耗时，但它的存在会让 Composer 更早触发 autoload 生成和插件注册——如果 PHP 扩展缺失（比如没开 mbstring）或 opcache 被禁用，这里就会无声卡住。
