在 Mac 上卸载 Hammerspoon
先在 Finder 按 Shift + Command + G 打开 ~/.hammerspoon，复制整个文件夹。你写的 Lua 脚本、装过的 Spoons 和 init.lua 都在这里，init.lua 是 Hammerspoon 启动时加载的入口（入门指南）。只复制一个脚本而漏掉入口文件，重装后快捷键可能不会恢复。如果脚本用 hs.settings 保存过数据，这些数据在 Hammerspoon 的偏好设置文件 ~/Library/Preferences/org.hammerspoon.Hammerspoon.plist 里，也要一起备份。本页覆盖 hammerspoon.org 官网的 zip 包和 Homebrew cask。
退出 Hammerspoon，移除应用
- 只想暂停自动化，退出应用即可。想阻止它登录时启动，在 Hammerspoon 的偏好设置里关掉对应选项，或到「系统设置 › 通用 › 登录项与扩展」核对它的条目。
- 从菜单栏图标退出 Hammerspoon，确认它提供的快捷键和自动化已经停止。
- 把 Hammerspoon 从「应用程序」移到废纸篓。
- 打开「系统设置 › 隐私与安全性 › 辅助功能」，选中 Hammerspoon，点减号按钮移除它的条目。不要手动改系统的权限或登录项数据库。
如果用 hs.ipc.cliInstall() 装过 hs 命令行工具，它会在 /usr/local/bin/hs 和 /usr/local/share/man/man1/hs.1 创建指向应用内部的链接（hs.ipc）。移除应用前在 Hammerspoon 控制台运行 hs.ipc.cliUninstall()，或者之后手动删掉这两个链接。
Hammerspoon 的文件在哪里
| 位置 | 存放内容 | 保留还是删除 |
|---|---|---|
~/.hammerspoon |
init.lua、你的脚本和 Spoons |
先备份；以后还要用就保留。 |
~/Library/Preferences/org.hammerspoon.Hammerspoon.plist |
应用偏好设置和 hs.settings 数据 |
脚本用了 hs.settings 就先备份。 |
/usr/local/bin/hs、/usr/local/share/man/man1/hs.1 |
hs 命令的链接（装过才有） |
应用删掉后可以删。 |
检查结果
pgrep -x Hammerspoon
ls -d ~/.hammerspoon
ls -l /usr/local/bin/hs
pgrep 没有输出，说明 Hammerspoon 已退出。卸载后若快捷键还在生效，先检查是否有另一份 Hammerspoon 正在运行，不要直接删掉脚本来测试。列出了 ~/.hammerspoon，说明脚本还在磁盘上，你主动保留时这是正常的。/usr/local/bin/hs 仍列出并指向 Hammerspoon.app，说明是失效链接；报 No such file or directory 则说明已经不在。辅助功能里残留的历史条目，不能证明脚本还在执行。
用 Homebrew 安装时
Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。
自己运行 brew uninstall --cask --zap hammerspoon 时，zap 清单不看你在 Mole 里勾了哪些行。清单里有存放脚本的 ~/.hammerspoon，以及带 hs.settings 数据的偏好设置文件，缓存和窗口恢复状态也在清单里。这次测试里 ~/.hammerspoon 留了下来，但不能指望这一点。先把两者都备份，或改用不带 zap 的 brew uninstall --cask hammerspoon 保留它们。这个 cask 还会把 hs 链接到 Homebrew 的 bin 目录，卸载时一并移除。
Mole 会列出什么
下文数据行不勾选的状态按「卸载时一并移除数据和配置」关闭时说明，这个选项默认关闭，开启后符合条件的应用自有需确认行可能预先勾选，想留的数据取消勾选，共享和受保护的数据仍需单独确认或继续保留。
| 位置 | 删除计划里的状态 |
|---|---|
~/.hammerspoon |
会列出，但不默认勾选。 |
~/Library/Preferences/org.hammerspoon.Hammerspoon.plist 和其他以 org.hammerspoon.Hammerspoon 命名的资源库项目 |
默认勾选。脚本用了 hs.settings 时，取消勾选偏好设置文件。 |
~/Library/Caches/SentryCrash/Hammerspoon |
默认勾选。 |
/usr/local/bin 中的 hs 若是指向这份 Hammerspoon.app 的符号链接，Mole 可以列出供确认，默认不勾选，man 手册链接不在这项启动入口扫描里。Hammerspoon
这次检查覆盖了什么
2026 年 9 月 17 日用 Homebrew cask 安装 Hammerspoon，启动后在运行状态下通过 Mole 卸载，Mole 先退出了它再移除。偏好设置、缓存和崩溃记录文件夹都已删除。首次启动创建的 ~/.hammerspoon（里面只有空的 Spoons 文件夹）虽然在 zap 清单里，却留在了磁盘上，Mole 现在会列出它。脚本、hs 命令和辅助功能授权都没有测试。