Hammerspoon 备忘录|用 macOS 自动化工具干了什么 & 安装、权限、配置、救急全攻略
一句话版:Hammerspoon(HS)是 macOS 上基于 Lua 的自动化工具——绑定全局快捷键、窗口管理、事件监控、脚本调度,全都能干。这篇是我自用存档:先说我在 Mac 上用 HS 实际干了什么,再说怎么装、怎么配、踩了哪些坑、被锁死怎么自救,实例放最后。 一、先说我在 Mac 上用 HS 干了什么 HS 的定位一句话形容:给 macOS 加的“系统级外挂”。所有功能都靠 ~/.hammerspoon/init.lua 里的一段 Lua 代码驱动,不挑应用、全局生效。我自己长期在用的几个场景: 窗口管理:把窗口甩到屏幕左/右/上/下半屏、快速分屏,不用鼠标拖来拖去; 全局快捷键:任何一个 App 里都能触发的热键,比如一键打开指定 App、一键跳到某目录; 自动切桌面/切空间:鼠标滚轮左右倾斜直接切换桌面,比如,罗技 M720 滚轮左右倾斜切换桌面,不用去触控板手势; 定时任务:写个 hs.timer 定时提醒、定时执行脚本; 事件监听:hs.eventtap 监听鼠标/键盘事件,按需触发动作;热键、改键用。 状态显示:菜单栏显示电池、网络等自定义信息。 核心思想:把重复操作变成一行热键/一段脚本。下面这份备忘录就是围绕这些用途的完整配置与排障手册。 二、前置说明 最低系统:macOS ≥ Ventura(13) 配置入口:~/.hammerspoon/init.lua,这是主配置文件,所有 Lua 脚本写在这里 ~:代表当前用户家目录 核心痛点:辅助功能权限是一切功能的前提;隐藏菜单栏图标之后,很容易把自己锁死 三、彻底卸载(重装前清理,踩坑必做) 如果之前装过、图标出不来、权限错乱,先清理干净再重装。 退出 Hammerspoon:菜单栏图标 → Quit Hammerspoon 把 /Applications/Hammerspoon.app 拖到废纸篓 清理系统权限(非常关键) 系统设置 → 隐私与安全性 → 辅助功能 在列表找到 Hammerspoon,选中,点 - 删除 如果之前装过 hs 命令行工具 rm -f /usr/local/bin/hs rm -f /usr/local/share/man/man1/hs.1 ✅ 保留配置文件夹:~/.hammerspoon 不动,里面的 init.lua、Spoon 插件可以复用,不用删 四、安装(二选一,优先 Homebrew) 方式 1:Homebrew(推荐,后续升级简单) brew install --cask hammerspoon 安装完成,启动台打开 Hammerspoon。
…