昨天升级 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 版。