Composer install报“git not found”是因为遇到dev分支、VCS仓库或--prefer-source时需调用git clone，而系统未安装Git或PATH未配置。
为什么composer install会报git not found
Composer 默认对 Packagist 上的稳定包走 ZIP 下载，但一旦遇到 dev- 开头的版本（如 "monolog/monolog": "dev-main"）、type: "vcs" 的自定义仓库、或你手动加了 --prefer-source，它就会尝试执行 git clone。此时若系统 PATH 里没有 git 命令，就会直接卡在 sh: git: not found 或 git was not found in your PATH。
这不是 Composer 故障，而是它依赖外部 Git 工具完成源码拉取——和 PHP 扩展没启用、curl 失败一样，属于环境缺失。
- 运行
git --version，无输出就确认没装或 PATH 没生效 - Windows 用户常见于装了 Git for Windows，但安装时没勾选 Add Git to the system PATH
- Linux（如 Ubuntu）只装了
git-core包，实际需要git元包：apt install git - macOS 用 Homebrew 安装后，路径可能是
/opt/homebrew/bin（Apple Silicon）或/usr/local/bin，得手动加进$PATH
怎么快速验证并修复Git环境
别靠“我记得装过”判断，终端新开一个窗口，逐条执行：
-
git --version—— 看是否输出类似git version 2.40.1 -
which git（macOS/Linux）或where git（Windows）—— 确认路径存在且可访问 -
composer diagnose—— 关键看最后一行是否显示Git binary found at /usr/bin/git
如果 git --version 成功但 composer diagnose 仍报未找到，说明 Composer 没读到你的 PATH：检查是否在当前 shell 配置文件（如 ~/.zshrc）里正确导出了 PATH，并重新加载（source ~/.zshrc）或换新终端。
适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……
不想装Git？用--prefer-dist绕过源码拉取
如果你只是部署生产环境、用 CI/CD 流水线、或 Docker 构建镜像，且不修改依赖源码，--prefer-dist 是最轻量的绕过方式。
- 运行
composer install --prefer-dist，强制所有包走 ZIP/TAR 归档下载 - 注意：它不解决所有问题——如果包没提供 dist（比如私有 GitHub 仓库没配置
"archive": {"exclude": ["..."]}），Composer 仍会 fallback 到 Git - CI 场景下建议加到命令末尾：
composer install --prefer-dist --no-interaction --optimize-autoloader - 想永久生效？设全局变量：
export COMPOSER_PREFER_DIST=1（写入 shell 配置）
Docker 或受限环境中的稳妥做法
在 Alpine、scratch 镜像或某些安全加固的 CI 节点上，装 Git 不仅冗余还增大攻击面。这时应从源头控制行为：
- Dockerfile 中避免临时装 Git：改用
FROM php:8.2-cli-alpine+RUN apk add --no-cache composer，再通过composer install --prefer-dist运行 - 确保
composer.json里没写"repositories"，尤其别出现"type": "vcs"或指向 GitHub/GitLab 的 URL - 检查
composer.lock是否含"source"字段（如"source": {"type": "git", ...}）—— 有则说明上次是用--prefer-source生成的，需清缓存后重生成 lock - CI 脚本开头加一句：
composer clear-cache && composer install --prefer-dist --no-dev
真正麻烦的不是没 Git，而是你既没装 Git，又依赖 dev 分支、私有 VCS 仓库、或 lock 文件残留 source 记录——这种组合会让 --prefer-dist 失效，必须回到环境补 Git 或重构依赖声明。
