加了--prefer-dist仍慢是因为它只控制下载方式（优先dist而非source），不加速网络；若镜像未切成功、缓存未清、或包无dist则fallback至source甚至失败，需先确认镜像源、清理缓存、检查prefer-source覆盖。
为什么加了--prefer-dist还是慢？
因为--prefer-dist本身不加速网络，它只决定「怎么拿包」：优先下载预构建的 ZIP/TAR（dist），而不是 clone Git 仓库（source）。但若镜像没切成功、缓存未清理、或包本身没 dist，它就 fallback 到 source，甚至失败——看起来像“加了没用”。
常见现象：composer install --prefer-dist卡在 downloading 或报错 Could not find a matching version of package。
- 先运行
composer config -g repo.packagist，确认输出是https://mirrors.aliyun.com/composer/而不是packagist.org - 再执行
composer clear-cache：旧缓存可能仍指向海外元数据，导致 dist URL 解析失败 - 检查项目
composer.json是否有"prefer-source": true—— 它会直接覆盖全局prefer-dist，必须删掉
--prefer-dist 和 preferred-install 有什么区别？
--prefer-dist 是命令行参数，只对当前命令生效；preferred-install 是配置项，控制长期行为，更可靠。
CI/CD 或团队协作中，推荐用配置而非临时参数，避免脚本漏传或被忽略：
- 全局生效（所有项目）：
composer config -g preferred-install dist - 项目级生效（写入
composer.json）：composer config preferred-install dist - 支持通配符，例如：
composer config preferred-install '{"*": "dist"}'
注意：preferred-install 在 Composer 2.2+ 中已替代旧版 prefer-dist 配置字段，且优先级高于环境变量 COMPOSER_PREFER_DIST。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
哪些包根本走不了 --prefer-dist？
不是所有包都提供 dist，尤其私有或开发中未打 tag 的包。强制启用只会失败，不会静默降级。
判断方式：composer show vendor/package，看输出里是否有 dist 字段（含 url 和 type，如 zip）。
- 私有 GitLab/GitHub 仓库未配置
archive模板 → 无 dist URL -
composer.json中只定义了"source": {...}，没写"dist": {...}→ 强制--prefer-dist直接报错 - 版本约束是
"dev-master"或"@dev"→ Packagist 不生成 dist，只能走 source
遇到这类包，要么让维护者补 dist 配置，要么接受 source 模式，别硬加参数。
真正卡顿的地方，往往和 --prefer-dist 无关
如果安装卡在 Resolving dependencies，说明还没开始下载——问题在本地 PHP 环境或锁文件，不是网络也不是 dist/source 选择。
- 检查
php -m | grep xdebug：xdebug 启用会让依赖解析慢 5–10 倍 - 运行
php -r "echo ini_get('memory_limit');"：低于 512M 容易在复杂依赖图中 OOM - 删掉
composer.lock和vendor/，用composer install --no-cache重试，排除 lock 文件残留问题
dist 模式只影响下载和解压阶段；解析、autoload 生成、脚本执行这些环节，--prefer-dist 完全不参与——别指望它解决所有慢的问题。
