--prefer-dist能绕过git报错是因为它强制composer跳过git clone等操作，直接从packagist下载预构建zip包；适用于ci/cd、docker等无git环境，但要求包已发布dist归档。
直接用 --prefer-dist 参数绕过 git，是最快能跑通 composer install 的办法。 它不依赖系统 git 命令，而是从 Packagist 下载预打包的 zip 归档，适用于绝大多数公开包。
为什么加 --prefer-dist 就不报 git 错了？
Composer 默认在遇到 dev 分支、vcs 类型仓库或 composer.lock 里记录的是 source 提交哈希时，会尝试执行 git clone。一旦系统找不到 git，就卡在这一步。加 --prefer-dist 后，Composer 强制走 dist 流程——跳过所有 clone、checkout、submodule 操作，只下载和解压 zip。
- 它不检查
git --version，也不读.git/config - 对 CI/CD、Docker、新装系统特别友好，无需先配 git
- 前提是目标包在 Packagist 上有发布 dist（主流包基本都有）
临时修复但不改环境时，怎么写命令？
别只输 composer install，必须显式带上参数：
composer install --no-interaction --prefer-dist --optimize-autoloader
-
--no-interaction防止卡在交互提示（比如 auth token） -
--optimize-autoloader加速 autoloader，不是必需但推荐 - 如果项目用了私有包且只提供 source（没发 dist），这条路会失败，得回头配 git
哪些情况 --prefer-dist 也救不了？
它不是万能开关。以下场景即使加了参数，仍可能因缺失 git 而失败：
-
composer.json 里声明了
"type": "vcs"且源地址是 Git URL（不是 HTTPS zip） - 某个依赖包的
composer.json显式写了"preferred-install": {"*": "source"} - 你手动删了
composer.lock，又没提交新的 lock 文件，导致 Composer 回退到 source 解析逻辑 - 用了
--prefer-source或设置了COMPOSER_PREFER_SOURCE=1环境变量
真正要一劳永逸，还是得让 git 可达——但如果你只是想立刻让 CI 构建通过、本地快速启动 demo，--prefer-dist 是最短路径。注意：它绕过了 git，也就绕过了 commit hash 校验和子模块控制，上线前确认依赖行为符合预期。
