Composer install必须调用git命令，因其本身不自带Git，仅调度系统git执行克隆；触发场景包括依赖声明为dev分支、vcs仓库配置、--prefer-source启用或lock文件记录source哈希；git缺失或配置不全（如user.name/email未设、SSH异常、vendor残留损坏.git）均导致失败。
Composer install 为什么必须调用 git 命令
因为 Composer 本身不带 Git，它只负责调度——当依赖声明为 dev-main、dev-develop，或 composer.json 中 "source" 类型是 git，或你用了 --prefer-source，它就会执行 git clone。这不是可选项，是硬性路径。
常见触发场景：
-
"monolog/monolog": "dev-main"这类开发分支引用 - 私有包的
repositories配置里 type 是vcs且 url 是 GitHub/GitLab 地址 -
composer.lock里记录的是 source 提交哈希（比如"reference": "a1b2c3..."），而非 dist ZIP URL
git not found 报错的本质是环境缺失
git is not recognized as an internal or external command 或 sh: git: not found，说明系统 PATH 里根本找不到 git 可执行文件。Composer 不会报“请先装 Git”，它只会失败并甩出底层 exec 错误。
验证方式（必须新开终端）：
One-click installation of GitHub projects
下载
GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
- Windows：运行
where git，无输出即失效；git --version报错也确认缺失 - macOS/Linux：运行
which git，返回空则未就位；git --version成功但git config --global user.name失败，说明 Git 安装不完整 - Docker/CI：基础镜像默认没 Git，Debian/Ubuntu 镜像需
RUN apt-get install -y git，Alpine 需RUN apk add --no-cache git
绕过 git 依赖的临时方案与代价
想跳过 Git 调用，可用 --prefer-dist 强制走 ZIP 包下载，但它只在满足条件时生效：
- 包在 Packagist 上有发布过的 stable tag（如
v2.10.0） - 依赖声明不是
dev-xxx，也不是dev-master这类分支别名 -
composer.lock当前记录的是 dist 信息（"dist"字段存在且含"url"）
如果 lock 文件里已是 source 记录，加 --prefer-dist 也不会自动重写——得先删掉 vendor/ 和 composer.lock，再跑 composer install --prefer-dist，否则仍会 fallback 到 git。
Git 配置不全也会导致 clone 失败
git --version 成功 ≠ git clone 一定能通。以下配置缺失常被忽略：
- 未设置全局用户信息：
git config --global user.name "Your Name"和git config --global user.email "you@example.com"，某些 Git 服务器（如 GitLab）会拒绝无 author 的 commit 操作 - SSH key 未添加或权限不对：用 SSH URL（
git@github.com:user/repo.git）时，ssh -T git@github.com必须成功 - HTTPS 协议被拦截：公司网络可能屏蔽或重写 HTTPS 请求，可临时试
git clone https://github.com/composer/composer.git看是否卡住 - vendor 目录下残留损坏的
.git：手动进vendor/some/package/.git执行git status，若报 error: bad signature 或 index file corrupt，直接删掉整个.git目录再重试
真正容易被忽略的点：很多团队在 CI/CD 流水线里只装了 git-core，但没装 git 元包（如 Ubuntu 的 git 包含 git-http、git-credential 等子命令），导致 HTTPS 克隆失败却查不出原因。
