如何在 Mac 上卸载 mGBA

移除 mGBA 的 Mac 应用前，先备份 ROM、游戏存档和即时存档，官方 FAQ记录了共享配置位置，模拟器也可以单独选择存档路径，本页覆盖官网 Mac 磁盘映像中的应用，其他 mGBA 前端分开处理。

先退出，再移除应用

先保存当前游戏和需要的即时存档，在 Settings › Paths 中检查 Save games 与 Save states 的位置，再退出 mGBA，复制这些文件和需要的 ROM 后，把 mGBA.app 移进废纸篓，其他安装的 mGBA 命令不随 GUI 应用一起移除。

哪些数据要留下

  • 记录中的测试观察到 ~/.config/mgba 保存配置和游戏库数据库，官方 FAQ 还支持在设置环境变量时使用 $XDG_CONFIG_HOME/mgba。
  • 默认家目录配置文件夹与 Homebrew 的 mgba 命令行 formula 共用，Mole 有意不把它列入 GUI 应用的卸载扫描，手动移除前先备份并检查其他使用者。
  • 游戏存档和即时存档可以使用独立路径，也可以与 ROM 同目录，实际文件单独保留，GUI cask 的 zap 只列 ~/Library/Preferences/com.endrift.mgba-qt.plist 和 ~/Library/Saved Application State/com.endrift.mgba-qt.savedState。

备份需要的存档和设置后，在访达按 Shift + Command + G，逐项打开完整路径，检查内容再把不需要且属于应用的数据移进废纸篓，共享配置和其他安装使用的文件留下。

检查卸载结果

pgrep -ifl mgba
command -v mgba
ls -ld /Applications/mGBA.app "$HOME/.config/mgba" "$HOME/Library/Preferences/com.endrift.mgba-qt.plist"

pgrep 没有输出只表示没有找到这个名称，不代表所有辅助进程都已退出，有输出时核对它的实际可执行文件路径，ls 提示路径不存在只说明这一处没有了，权限错误仍无法判断，留下的文件夹也可能是你要保留的数据。

command -v 显示当前 shell 找到的命令，不是正在运行的进程，没有路径只说明当前 PATH 找不到它，留下的命令可能属于另一种安装。

用 Homebrew 安装时

GUI cask 是 mgba-app，与命令行 formula mgba 不同，没有单独的卸载辅助程序，zap 只移除精确偏好设置和保存状态，不包含 ~/.config/mgba、ROM 或另存的游戏存档。

不运行 zap 时，用下面的命令卸载：

brew uninstall --cask mgba-app

Mole 会先核对 Homebrew 的整份删除清单，涉及未勾选的数据、共享文件或无法确认的内容时跳过 --zap，已勾选的残留仍由 Mole 清理。自行运行 brew uninstall --cask --zap mgba-app 会执行 Homebrew 的完整 zap 清单，不会读取 Mole 的勾选状态。

当前 cask。

Mole 会列出什么

Mole 默认勾选应用和可归属临时缓存，有精确偏好设置时也默认勾选，不把共享的 ~/.config/mgba 目录列入这个 GUI 应用的清单，ROM 和存档在实际位置保留，留下共享配置是有意保留，不是卸载失败。

这些是「卸载时一并移除数据和配置」关闭时的选择，打开后，符合条件的待确认应用数据也可能勾选，共享数据、受保护的资料和 Agent 工作档案仍按原有方式逐项确认或保持锁定，卸载前核对最终清单。

这次检查覆盖了什么

2026 年 9 月 25 日，从官网 Mac 磁盘映像拷出的 mGBA 0.10.5 用 Mole 开发构建测试，应用和观察到的临时缓存已移除，共享的 ~/.config/mgba 保留，没有核验 ROM 运行、即时存档恢复或独立命令行安装。

逐款软件检查的记录方法。