Composer因Git版本过低（
如果您尝试通过 Composer 安装依赖包，但因系统 Git 版本过低而触发“git was not found”或“Your git version is too old”等错误，导致项目下载失败，则可能是由于 Composer 在执行 clone 或 checkout 操作时依赖 Git 的特定功能（如 shallow clone、refspec 支持等），而旧版 Git 缺乏兼容性。以下是解决此问题的步骤：
一、检查当前 Git 版本并确认是否过低
Composer 在执行 git-based 包安装（如 vcs repositories）时，要求 Git 版本不低于 1.9.5（推荐 ≥2.1.0）。低于该版本可能无法正确处理 --depth=1 参数或 refs/pull/xxx/head 等 GitHub Pull Request 引用格式，从而中断下载流程。
1、在终端中运行 git --version 查看当前 Git 版本。
2、若输出为 git version 1.8.3 或更低（例如 CentOS 6 默认 Git），则确认属于需升级范围。
3、执行 composer diagnose，观察输出中是否包含 Git version is too old 提示。
二、升级系统 Git（适用于 Linux 发行版）
直接替换系统自带 Git 二进制文件可避免路径冲突与权限问题，同时确保 Composer 调用到新版 Git。
1、下载最新稳定版 Git 源码（例如 Git 2.45.2）：wget https://github.com/git/git/archive/refs/tags/v2.45.2.tar.gz。
2、解压并进入源码目录：tar -xzf v2.45.2.tar.gz && cd git-2.45.2。
3、编译安装到 /usr/local：make prefix=/usr/local all && sudo make prefix=/usr/local install。
4、刷新 PATH 并验证：export PATH="/usr/local/bin:$PATH" && git --version，确认输出为新版本。
三、使用包管理器升级 Git（Ubuntu/Debian）
通过官方 PPA 可安全获取较新 Git 版本，无需手动编译，适合生产环境快速部署。
1、添加官方 Git PPA 仓库：sudo add-apt-repository ppa:git-core/ppa -y。
2、更新软件包索引：sudo apt update。
3、升级 Git 及其依赖：sudo apt install git -y。
4、验证版本：git --version，应显示 ≥2.30.0。
四、更换 Git 路径（当系统存在多版本 Git 时）
Composer 默认调用 $PATH 中首个 git 命令。若系统已安装新版 Git 但未被识别，可通过配置强制指定路径，绕过版本检测逻辑。
1、查找新版 Git 位置：which git（如返回 /usr/local/bin/git）。
2、设置 Composer 全局 Git 路径：composer config --global git.bin /usr/local/bin/git。
3、清除 Composer 缓存以避免旧 Git 路径残留：composer clear-cache。
4、再次运行 composer install，确认不再报 Git 版本错误。
五、临时禁用 Git 功能（仅限调试与紧急规避）
当无法立即升级 Git 且需快速完成依赖安装时，可让 Composer 回退至 zip 包下载模式，跳过所有 Git 操作。该方式不修改 Git 本身，但会丢失 commit hash 锁定与 dev 分支实时同步能力。
1、启用 dist-only 模式：composer config --global prefer-stable true && composer config --global prefer-dist true。
2、强制忽略 VCS 信息：composer config --global disable-tls false（确保 HTTPS zip 下载可用）。
3、执行安装时添加 --no-plugins 和 --no-scripts 参数减少扩展依赖：composer install --no-plugins --no-scripts。
4、若仍失败，可尝试全局禁用 Git 协议：composer config --global github-protocols https，防止 fallback 到 git:// 协议。
