装了新版Git，终端却仍显示旧版本，先检查“现在执行的是哪一个文件”，不要反复安装。软件已经在磁盘上，与Shell或IDE选择了它，是不同层次的问题。

2023年的现象：装完仍是2.15

当时IDEA反复提示Git版本过低，我执行 brew install git 后，用 git --version 检查，仍看到2.15。随后执行过 brew link git --overwrite，版本显示变成2.39。

这说明命令的实际解析结果发生了变化，但没有保留完整PATH和链接前后证据，不能断言只有某一种原因。

先收集路径和安装状态

type -a git
command -v git
git --version
brew --prefix
brew --prefix git
brew list --versions git

type -a 有助于发现别名、函数和多个同名命令；command -v 看当前解析结果。对照Homebrew前缀下的Git与系统Git，才能判断是PATH次序、缺链接，还是运行了别的安装。

当时记录里的 /usr/local 不是所有Mac的固定路径；应以本机 brew --prefix 为准，不要把Intel环境路径硬套到另一台机器。

先预览冲突，不先覆盖

确认安装确实存在、但链接有问题时，可以先查看将受影响的文件：

brew link --overwrite --dry-run git

这是预览。Homebrew说明 link --overwrite 会在链接时删除前缀中冲突的现有文件；只有确认这些目标归属、知道如何恢复后才执行真实修改。普通链接问题也未必需要overwrite。Homebrew link手册

如果安装与链接正常，继续检查PATH、Shell配置加载及命令缓存，重新打开终端后再次核对实际路径。链接命令不会自动解决所有搜索顺序问题，更不应删除macOS自带的Git来强行切换。

IDEA还可能使用另一个Git

终端恢复后，检查IDEA配置的Git可执行文件路径，并使用IDE提供的测试功能。IDE的环境、显式配置和启动方式可能与交互Shell不同。

最终验证应是“终端和IDE分别使用了预期路径与版本”，而不只是安装器显示完成。