加--prefer-dist能加速安装，但需验证是否真正生效：运行composer install -v，若输出含Downloading HTTPS ZIP URL且无Cloning字样、vendor内无.git目录、composer show -s显示非空dist URL，才确认走dist模式。
加 --prefer-dist 能让 Composer 从 ZIP/TAR 包安装依赖，而不是 git clone，对绝大多数生产场景是更快、更轻、更稳的选择；但它不是万能开关，包没发版、配置冲突或环境变量覆盖时，它会静默失效。
怎么确认当前安装是否真的走了 dist？
别只看命令里有没有写 --prefer-dist，得看实际行为：
- 加
-v参数运行composer install -v，输出中出现Downloading https://...（URL 指向 zipball 或 archive）且无Cloning或git clone字样，才是真走 dist - 检查
vendor/xxx目录：没有.git文件夹，基本可断定是 dist 模式；有.git就一定是 source - 运行
composer show -s vendor/package，看输出里dist字段是否非空，且url是 HTTPS ZIP 链接
为什么加了 --prefer-dist 还在 git clone？
常见原因不是参数没起作用，而是条件不满足，Composer 自动 fallback 到 source：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 依赖包只有
dev-master或dev-main这类开发分支约束，没打正式 tag，Packagist 就没法生成 dist 信息 - 项目
composer.json中该包被显式设为"source": { ... }，且没配对应dist - 本地
vendor/xxx已存在且是 source 模式，而composer.lock未更新，Composer 会复用旧目录 - 设置了环境变量
COMPOSER_PREFER_SOURCE=1，它优先级高于命令行参数 - 私有包没在仓库配置
archive或没发布 GitHub Release，dist URL 为空
怎么确保大型包一定走 dist？
靠临时参数不够稳，尤其在 CI/CD 或团队协作中：
- 项目级控制：在
composer.json的config段加"preferred-install": "*": "dist"，比每次敲命令更可靠 - 全局控制（推荐用于 CI）：
composer config -g preferred-install dist，但开发机慎用，否则调试时改不了源码 - 混合策略（最实用）：
"preferred-install": { "myorg/*": "source", "*": "dist" }，自家私有包保留 git，第三方全走压缩包 - 部署前加保险：
composer install --prefer-dist --no-dev --optimize-autoloader，三者组合能压榨出最大效率
dist 下载失败时别只盯参数
--prefer-dist 本质是走 HTTP(S) 下载 ZIP，和 Git 协议完全无关。失败往往卡在链路层：
- 报错
Failed to download xxx: Invalid URL format？说明dist.url字段被误写成git@github.com:这类 SSH 格式，必须是 HTTPS - 超时或 403？检查
dist.url是否能浏览器直连，是否被企业防火墙拦截，GitHub Releases 是否被墙 - 校验失败？
dist.shasum不匹配，可能是镜像源同步滞后，或包作者上传 ZIP 后忘了更新 shasum - 私有 GitLab/Bitbucket 仓库要支持 dist，必须开启 archive 功能并配置好 webhook，否则
--prefer-dist形同虚设
真正容易被忽略的是：dist 模式下你拿不到 .git，也就没法用 git log 查变更、没法直接 git diff 看 patch、也没法顺手 git commit 提 PR——这不是 bug，是设计使然。想改代码，就得切到 --prefer-source，或者用 path repository 本地挂载。
