Composer报“Git not found”是因系统git命令在当前执行环境中不可用，常见于PATH未生效、Shell配置未加载、运行用户不一致或Git未安装；需在纯净终端验证git --version和which git，并确保composer继承正确PATH。
Composer 报“Git not found”不是 Composer 坏了，而是它在某个环节**必须调用系统 git 命令**，但当前执行环境里压根找不到 git 可执行文件——装没装、在哪装、谁在跑、PATH 对不对，四者缺一不可。
为什么 git --version 成功，composer diagnose 还报错？
这是最典型的「环境错位」：你在交互式终端（比如 zsh）里配好了 PATH，但 composer diagnose 可能由 Web 服务（www-data）、CI runner（如 GitHub Actions 的 runner 用户）、Docker 容器或 IDE 内置终端触发，这些上下文默认不加载你的 ~/.zshrc 或 ~/.bash_profile。
- 新开一个纯净终端（关掉所有已有窗口再开），运行
git --version和which git，确认路径输出 - 接着立刻运行
composer diagnose，看是否仍标 WARNING - 如果仍失败，检查 shell 配置里有没有类似
[[ -n $PS1 ]] && export PATH=...这种只对交互式 shell 生效的判断，非交互式 shell 会跳过 - 临时验证：直接用完整路径调用，例如
GIT_EXECUTABLE=/opt/homebrew/bin/git composer diagnose
composer install 卡在 sh: git: not found 怎么绕过？
绕过不是删掉问题，而是告诉 Composer：“别碰 git，全给我走 zip”。但前提是包得真有 dist 归档，否则它会静默 fallback 回 source，然后再次失败——日志里可能只写 Failed to download vendor/package，根本不提 git。
- 加
--prefer-dist参数：适合本地快速验证，但不持久 - 项目级锁定：
composer config prefer-dist true，写入composer.json的"config"段 - 全局禁用 source：
composer config --global preferred-install "dist"，比命令行参数更彻底 - CI 场景务必加
--no-plugins --no-scripts，防止某些插件偷偷调用git - 验证是否生效：运行
composer install -vvv，看到Downloading https://.../package.zip才算成功；若仍有Executing command (CWD): git clone，说明某处还在 force source
Windows 上 git 不是内部或外部命令 怎么修？
这几乎 100% 是 Git for Windows 安装时漏选了 “Add Git to the system PATH”。GitHub Desktop、VS Code 内置 Git 都不等于系统级 git 可用。
- 检查路径是否存在：
C:\Program Files\Git\bin\git.exe或C:\Users\{user}\AppData\Local\Programs\Git\bin\git.exe - 把对应
bin目录（不是cmd）加进系统环境变量PATH - 重启 CMD / PowerShell / IDE —— 已打开的窗口不会自动刷新环境变量
- 验证方式：在新 CMD 中运行
where git，有输出才算真正生效 - 安装时关键选项：选 “Git from the command line and also from 3rd-party software”，不是 “Only use Git from Git Bash”
macOS/Linux 的 which git 输出路径，Composer 就认吗？
不一定。Homebrew 在 Apple Silicon 上默认装到 /opt/homebrew/bin/git，而很多老脚本和 PHP 子进程只认 /usr/local/bin；Ubuntu 用户如果只装了 git-core，实际缺的是 git 元包。
- 运行
which git，看输出是不是/opt/homebrew/bin/git（M1/M2/M3）或/usr/bin/git（Linux） - macOS：编辑
~/.zshrc，追加export PATH="/opt/homebrew/bin:$PATH"，然后source ~/.zshrc - Ubuntu/Debian：别只装
git-core，运行sudo apt install git（这才是含git命令的元包） - Docker 场景：在
Dockerfile中明确安装，例如RUN apt-get update && apt-get install -y git（Debian）或RUN apk add --no-cache git（Alpine） - 最容易被忽略的是用户权限：Web 服务器用户（如
www-data）或容器非 root 用户的PATH，可能和你登录用户完全不同
真正卡住人的从来不是“要不要装 Git”，而是“哪个用户、在哪个上下文、读了哪份 PATH、调用了哪个 git 二进制文件”。环境变量不刷新、shell 配置不重载、用户上下文不一致——这三个点，90% 的排查都折在这儿。
