如何在 Mac 上卸载 GitUp
卸载 GitUp 时保留自己的 Git 仓库,先结束正在进行的 Git 操作并保存未提交的工作,再退出应用,删除客户端和删除仓库及其 .git 数据是两回事。本文覆盖官网 Mac 应用和 Homebrew cask gitup-app。
退出 GitUp 并移除应用
按 Command + Q 退出 GitUp,再把「应用程序」里的 GitUp.app 移到废纸篓,如果 macOS 提示仍在使用,先到活动监视器检查。官方项目文档说明,GitUp 直接操作磁盘上的仓库,卸载时保留这些工作目录。
检查偏好设置,不删除仓库
下面的位置来自 Homebrew cask,记录中的卸载也移除了 GitUp 的偏好设置和 HTTP 存储,这些不是保存源代码的文件夹。
| 位置 | 怎么处理 |
|---|---|
| ~/Library/Caches/co.gitup.mac | GitUp 自己的缓存,退出后检查。 |
| ~/Library/HTTPStorages/co.gitup.mac | 应用自己的 HTTP 状态,重装还需要时保留,不需要时退出后再删除。 |
| ~/Library/Preferences/co.gitup.mac.plist | 偏好设置,保留原配置时留下,想重置时再删除。 |
在访达中按 Shift + Command + G,逐个查看这些路径,不存在的就跳过。不要把项目目录、.git 目录、SSH 密钥或系统 Git 安装一起删掉。
cask 还列出了 Apple sharedfilelist 存储中的 GitUp 最近文档条目,不要手动删除这个共享父目录或其他应用的条目。
检查应用和命令行入口
pgrep -il GitUp
ls -d /Applications/GitUp.app "$HOME/Library/Preferences/co.gitup.mac.plist"
command -v gitup
pgrep 没有输出,表示没有名称匹配的进程在运行,有输出时到活动监视器确认。ls 打印的路径还在,找不到文件表示该路径不存在,权限错误则无法判断。command -v gitup 显示当前 shell 能找到的命令,没有输出只表示它不在该 shell 的 PATH 中,如果还有命令,先确认由哪份安装提供,再决定是否移除。
用 Homebrew 安装时
brew uninstall --cask gitup-app
这条命令不执行 zap,cask 同时管理 GitUp.app 和它的 gitup 命令链接,普通卸载不只移除应用图标。
自己执行 brew uninstall --cask --zap gitup-app 会额外处理 cask 中的缓存、HTTP 存储、偏好设置和最近文档清单,不读取 Mole 的勾选结果,要保留这些状态时不加 zap。
Mole 会先核对 Homebrew 的整份删除清单,涉及未勾选的数据、共享文件或无法确认的内容时跳过 --zap,已勾选的残留仍由 Mole 清理。
Mole 会列出什么
存在时,GitUp 自己的 bundle 标识缓存、HTTP 存储和偏好设置默认勾选,Mole 也能列出 GitUp 自己精确匹配的最近文档文件并默认勾选,共享的 sharedfilelist 父目录和其他应用的清单仍受保护,保留偏好设置时将对应项取消勾选。
自己的仓库和单独安装的 Git 工具不在这款应用的卸载清单里。
这次检查覆盖了什么
2026 年 9 月 21 日,将官网包里的 GitUp 1.5.0 拷到「应用程序」,打开后卸载,没有 Homebrew 收据。应用、偏好设置、HTTP 存储和确认归属的临时缓存进入了废纸篓,该次删除清单没有记录到仍在磁盘上的条目,没有验证 Homebrew 管理的 gitup 链接,也没有验证仓库和 GitUp 专属历史的恢复。
