CentOS 7 默认 Git 1.8.3.1 不支持 restore、--filter=blob:none 等现代功能，且 yum install git 无法升级至 2.43.0——因官方源锁死在 1.8.3.1、EPEL 7 已停更最高仅 2.34.1；唯一可靠方案是源码编译安装 2.43.0，需卸载 perl-Git、装齐依赖（含 asciidoc/xmlto）、执行 make prefix=/usr/local/git all && sudo make install，并通过 /etc/profile.d/git.sh 优先配置 PATH。
CentOS 7 默认 git --version 输出 1.8.3.1，这个版本不支持 git restore、--filter=blob:none、commit-graph 等现代功能，CI/CD 流程中极易静默失败。必须升级——但不能直接 yum update git，那只会卡在 2.18.x 或更低。
为什么 yum install git 不行（尤其 CentOS 7）
CentOS 7 官方 base 源的 Git 锁死在 1.8.3.1；EPEL 7 虽提供更新版本，但自 2023 年起已停止维护，当前镜像中最高仅到 git-2.34.1；而 2026 年主流 LTS 版本是 git-2.43.0（2023 年 10 月发布），关键特性如 git switch、git worktree list --verbose、HTTP/2 支持等均依赖 2.39+。
- 运行
yum info git查看实际可用版本，别信“最新”描述 -
yum install git2u（IUS 源）可能装上 2.39.x，但 IUS 已多年未更新，部分机器会因perl-Git冲突导致git config报Can't locate Git.pm - 用
curl | bash类一键脚本，大概率覆盖系统/usr/bin/git并破坏符号链接，后续yum update可能直接报glibc错误
源码编译安装：路径、依赖与关键参数
这是目前 CentOS 7 上唯一能稳定落地 git-2.43.0 的方式，核心是避开 RPM 依赖锁死，独立部署到非系统路径。
- 先卸载旧版：
yum remove git git-* -y（必须清掉perl-Git，否则make install后git help会段错误） - 装编译依赖：
yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel gcc perl-ExtUtils-MakeMaker asciidoc xmlto -y（asciidoc和xmlto缺一不可，否则make install会卡在文档生成） - 下载并解压：
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.43.0.tar.xz && tar -xf git-2.43.0.tar.xz - 进源码目录后，**不要运行
./configure** ——Git 的 Makefile 已内置默认配置，直接执行：make prefix=/usr/local/git all && sudo make prefix=/usr/local/git install - 验证路径：
/usr/local/git/bin/git --version应输出git version 2.43.0
环境变量与 PATH 冲突怎么破
系统自带的 /usr/bin/git 被卸载后，PATH 中若仍有旧路径残留（比如某些脚本硬编码了 /usr/bin/git），或新 bin 目录没加到最前，就会调用错版本。
- 设新 Git 优先级最高：
echo 'export PATH=/usr/local/git/bin:$PATH' >> /etc/profile.d/git.sh && source /etc/profile.d/git.sh - 检查生效：
which git必须返回/usr/local/git/bin/git；git --version必须是 2.43.0 - CI 节点要额外注意：
Jenkins或GitLab Runner的 shell 环境可能不加载/etc/profile.d/，需在 job 脚本开头显式export PATH=/usr/local/git/bin:$PATH - 别用
alias git='/usr/local/git/bin/git'—— alias 在非交互式 shell（如 cron、pipeline）中无效
真正麻烦的不是编译本身，而是旧版依赖残留（尤其是 perl-Git）和 PATH 加载顺序。一次没清干净，后续所有 git submodule update 或 git push --force-with-lease 都可能行为异常，且错误日志里根本不会提版本问题。
