如何在 Mac 上卸载 Keyboard Maestro
Keyboard Maestro 的编辑器和后台 Engine 是两个独立进程,官方要求按固定顺序退出,你的宏放在应用之外的 ~/Library/Application Support/Keyboard Maestro,动手删任何东西之前先把这个文件夹拷到安全的地方,官方给的换机迁移办法也是拷这个文件夹。这篇覆盖官网 keyboardmaestro.com 下载的版本(bundle id com.stairways.keyboardmaestro.editor)和 Homebrew cask keyboard-maestro,装的是同一个安装包。
先退出 Engine 和编辑器,再移除应用
- 打开 Keyboard Maestro,在「通用」偏好设置里关掉「Launch Engine at Login」。
- 从「文件」菜单选择「Quit Engine」,停掉后台 Engine。
- 从「Keyboard Maestro」菜单选择「Quit Keyboard Maestro」,关闭编辑器。
- 在 Finder 的「应用程序」里找到 Keyboard Maestro,移到废纸篓。
数据在哪里
在 Finder 按 Shift + Command + G,逐个检查下面的路径。
| 位置 | 里面是什么 | 怎么处理 |
|---|---|---|
~/Library/Application Support/Keyboard Maestro |
你的宏 | 删除前先备份,这不是可以随便丢的应用数据 |
~/Library/Preferences/com.stairways.keyboardmaestro.plist、com.stairways.keyboardmaestro.editor.plist、com.stairways.keyboardmaestro.engine.plist |
官方列出的 com.stairways.keyboardmaestro.* 这组偏好设置文件 |
可以删除,从头开始 |
~/Library/Preferences/.Hidden Keyboard Maestro * Prefs |
一个隐藏的偏好设置文件,* 代表文件名其余部分 |
和其他偏好设置一起删除 |
~/Library/Logs/Keyboard Maestro |
日志文件 | 可以安全删除 |
~/Library/Saved Application State/com.stairways.keyboardmaestro.editor.savedState |
编辑器窗口状态 | 可以安全删除 |
检查结果
pgrep -il "keyboard maestro"
launchctl list | grep -i keyboardmaestro
ls -d ~/Library/Application\ Support/Keyboard\ Maestro
pgrep 没有输出,说明编辑器和 Engine 都没有在运行。launchctl list 没有输出,说明当前会话没有加载 Keyboard Maestro 的任务,列出一行就先把这个任务停掉再收尾。ls -d 报「No such file or directory」表示宏库文件夹已经不在;打印出路径说明还在,如果你是故意保留的,这是正常结果。
用 Homebrew 安装时
Mole 会先检查 zap 清单,涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap,已勾选的残留仍由 Mole 清理。
keyboard-maestro 这个 cask 的 zap 清单包含 ~/Library/Application Support/Keyboard Maestro(你的宏),一条「最近使用的文档」记录 ~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.stairways.keyboardmaestro.editor.sfl*,编辑器和 Engine 的缓存,以及上面那些日志、偏好设置和窗口状态。Mole 会列出宏文件夹但默认不勾选,你不勾它,Mole 卸载 Homebrew 装的 Keyboard Maestro 时就不加 --zap,只移除你留着勾的几行。自己运行 brew uninstall --cask --zap keyboard-maestro 会把清单上的东西全部移到废纸篓,不看 Mole 里的勾选,隐藏的 ~/Library/Preferences/.Hidden Keyboard Maestro * Prefs 不在清单里,这个文件由 Mole 自己单独列出。
想保留宏,先备份 ~/Library/Application Support/Keyboard Maestro,或者只移除应用:
brew uninstall --cask keyboard-maestro
Mole 会列出什么
~/Library/Application Support/Keyboard Maestro 会列出但默认不勾选,由你在保留宏和腾出空间之间选择。~/Library/Preferences/com.stairways.keyboardmaestro.editor.plist、~/Library/Saved Application State/com.stairways.keyboardmaestro.editor.savedState 和 ~/Library/Logs/Keyboard Maestro 存在时默认勾选,隐藏的 .Hidden Keyboard Maestro * Prefs 会列出但默认不勾选,想删就自己勾上。
这次检查覆盖了什么
2026 年 9 月 20 日,把官网下载包里的 Keyboard Maestro 11.1.1 拷进「应用程序」,没有 Homebrew 安装记录,也没有给它要的辅助功能权限,再用 Mole 1.15 Preview(build 280)卸载,审查列表展开后全选,~/Library/Application Support/Keyboard Maestro(176 KB)和应用一起进了废纸篓,/Library 下也没有装任何助手。宏同步、已注册的授权和 Homebrew cask 这次都没有测试。
