返回博客列表
开发

升级 macOS 27 后,Git 在 GUI 应用里“消失”了

一个躲了十年的 Intel 版 /usr/local/bin/git 软链接,让所有使用 git 的 App 都报错了。

作者: Bear. Best
2026/8/8
5 分钟阅读
分享:
升级 macOS 27 后,Git 在 GUI 应用里“消失”了

昨天升级 macOS 27 Golden Gate 后,Claude Code 一直报 Git is required for local sessions,VSCode 的源代码管理面板也说没装 Git。可在终端跑 git status,一切正常。

最后查到,系统里还留着一个 Intel(x86_64)版的旧 Git。GUI 应用先找到了它,执行失败后就报 Git 不存在。终端用的是另一个版本,所以没受影响。

旧 Git 无法运行的根本原因是 macOS 27 取消了 Rosetta 2,不再运行 Intel(x86_64)二进制。这个一直留在系统里的老版本,也就从升级后开始报错了。

找到那个旧 Git

先列出 PATH 中所有叫 git 的文件:

echo $PATH | tr ':' '\n' | while read dir; do
  [ -e "$dir/git" ] && echo "$dir/git" && ls -la "$dir/git"
done

我看到的是类似这样的软链接:

/usr/local/bin/git
lrwxr-xr-x  1 you  admin  14 Jun 28  2017 /usr/local/bin/git -> ../git/bin/git

链接的时间还是 2017 年。我接着直接运行这个路径,确认它还能不能用:

/usr/local/bin/git --version

报错是 zsh: bad CPU type in executable,也就找到了出问题的版本。

为什么终端能用,GUI 却不能

终端和 GUI 应用拿到的环境变量不一定相同。终端会读取 shell 配置,.zshrc 把 /opt/homebrew/bin 这样的新路径排在前面,先找到能运行的 Git。GUI 应用可能拿到系统级 PATH,先遇到 /usr/local/bin/git 这个旧版本。

我这里就是旧版本执行失败,应用却把它报成了“没安装”。后面即使还有可用的 Git,也没有继续用到。

删除旧软链接

确认出问题的是这个软链接后,删除它:

rm /usr/local/bin/git

Apple 自带的 /usr/bin/git 还在。删除旧链接后,GUI 应用就可以使用后面的系统 Git。如果还想用 Homebrew 版,可以再装一个 ARM 版本。

其他 Intel 老工具也看一遍

同样的问题也可能出现在别的旧工具上。可以扫一遍 PATH:

echo $PATH | tr ':' '\n' | while read dir; do
  for f in "$dir"/*; do
    [ -f "$f" ] && [ -x "$f" ] && \
    file "$f" 2>/dev/null | grep -q "x86_64" && \
    echo "Intel: $f"
  done
done 2>/dev/null

我还找出一个 Intel 版的 thefuck,每次开终端都先报 bad CPU type,用 brew reinstall thefuck 重装后就正常了。

以后再遇到 GUI 应用说某个工具没装,我会先看看 PATH 里是否有同名旧版本,再确认它的架构和运行情况,然后决定删除还是换成 ARM 版。

#macOS#Git#Homebrew#Claude Code#VSCode#系统排查