为什么需要完全卸载Git
很多开发者在升级软件或更换版本时，经常遇到命令冲突、环境变量混乱或者路径指向错误的问题。Mac系统自带的终端环境比较特殊，如果之前通过不同方式多次安装过Git，直接覆盖安装往往无法清除旧版本的残留文件。这些隐藏的配置项和缓存不仅占用磁盘空间，还可能导致后续拉取代码或提交记录时出现权限报错。因此，彻底卸载并清理相关文件，是解决各类Git异常的最稳妥办法。
第一步：确认当前的安装来源
在动手删除之前，必须先搞清楚你电脑上装的是哪个版本的Git，以及它是怎么进来的。打开终端应用程序，输入 which git 并按回车。如果终端返回类似 /usr/local/bin/git 的路径，说明大概率是通过Homebrew安装的。如果返回的是 /opt/homebrew/bin/git，那你用的是Apple Silicon芯片的Mac且通过Homebrew安装。若显示 /Library/Frameworks/Git.framework 或者 /usr/bin/git，则可能是官方安装包或Xcode命令行工具自带的版本。这一步非常关键，选错卸载方法只会浪费时间。
第二步：针对不同来源执行卸载操作
如果你是通过Homebrew安装的，这是目前最主流的渠道，卸载起来也最简单。直接在终端运行 brew uninstall git 命令即可。执行完后，建议再跑一次 brew cleanup 清理掉关联的依赖包和旧版本缓存。如果是通过官网下载的dmg安装包，你需要手动找到安装目录并删除。通常位置在 /usr/local/git 或者 /Applications/Git.app 文件夹。直接将其拖入废纸篓后，记得去系统偏好设置里把相关的启动项关闭。对于Xcode命令行工具自带的Git，苹果并没有提供直接的卸载按钮。你可以通过 xcode-select --install 重新安装来覆盖，但想彻底移除的话，只能进入 /Library/Developer/CommandLineTools/usr/bin 目录下，手动删除 git 可执行文件及相关链接库。不过强烈不建议普通用户动系统自带文件，除非你有十足的把握。
第三步：深度清理残留配置与缓存
程序删干净了，不代表工作痕迹也跟着消失了。Git会在你的用户主目录下偷偷留下不少配置文件。打开终端，依次输入 rm -f ~/.gitconfig 和 rm -f ~/.gitignore_global 来清除全局账号绑定和默认忽略规则。接着用 rm -rf ~/.git 删除可能存在的本地仓库元数据备份。如果你的项目曾经配置过SSH密钥，建议检查 ~/.ssh 目录，把不再需要的 id_rsa 或 id_ed25519 公钥私钥对一并移除，避免多套凭证互相干扰。此外，部分第三方客户端如SourceTree或Fork会在 ~/Library/Application Support 下生成独立的缓存，顺着路径找出来删掉，能让系统恢复清爽。别忘了同时清理 ~/Library/Caches 文件夹下跟Git相关的临时文件，防止旧版本的数据干扰新环境的初始化。
第四步：验证卸载结果与后续建议
所有步骤走完后，再次打开终端，直接敲击 git --version。这时候屏幕应该会提示 command not found 或者找不到该指令，这就代表底层二进制文件已经成功剥离。为了保险起见，可以顺便重启一下终端会话，甚至重启电脑，确保环境变量彻底刷新。如果你打算重新安装Git，推荐优先使用Homebrew方式，方便日后统一管理版本。安装前务必核对当前项目的依赖要求，避免因为版本跨度太大导致某些老旧脚本跑不起来。平时养成定期备份 .gitconfig 的习惯，重装后只需一行复制命令就能快速恢复之前的别名和推送策略，省去重复配置的麻烦。遇到权限不足时，千万不要随意加 sudo，正常用户的家目录操作不需要管理员权限，乱用反而会导致后续文件归属权混乱。
