Hammerspoon
> Hammerspoon — 把 macOS 的每一个角落都变成你的自动化乐高，用 Lua 拼出效率神器。
好，咱们直接进入正题。今天聊一个我用了三年多、几乎每天都在折腾的 macOS 工具——Hammerspoon。如果你跟我一样，是个“这破电脑怎么就不能按我的想法来”的重度用户，那这玩意儿绝对会让你颅内高潮。
### 这货到底是干嘛的？
简单说，Hammerspoon 是 macOS 上的一个自动化引擎。它给你提供了一个桥梁，让你可以用 Lua 脚本语言去控制 macOS 的几乎所有系统级功能：窗口管理、快捷键、鼠标键盘模拟、剪贴板、文件系统、音频设备、Wi-Fi 切换、电池状态……只要你能想到的系统 API，它基本都暴露给你了。
它解决的最大痛点就是：**macOS 自带的功能太“乖”了，不给力**。比如系统自带的窗口管理，只能全屏或分屏左右两半，想要“左三分之一右三分之二”或者“窗口移动到另一个显示器并放大”，得装一堆付费软件。Hammerspoon 用 20 行代码搞定，而且免费开源。
### 怎么装？
安装很简单，两种方式：
1. **直接下载**：去 [官网](https://www.hammerspoon.org/) 下载最新版 `.zip`，解压后把 `Hammerspoon.app` 拖到“应用程序”文件夹，打开就行。
2. **Homebrew 党**：终端执行 `brew install --cask hammerspoon`，然后手动打开一次。
打开后，你会发现菜单栏多了一个锤子图标。点它，选“Open Config”，会打开你的配置文件 `~/.hammerspoon/init.lua`。这个文件就是你的“游乐场”。
**注意**：第一次打开会提示你开启辅助功能权限（Accessibility），因为要模拟键盘鼠标和监听全局快捷键，必须去“系统设置 -> 隐私与安全性 -> 辅助功能”里勾选 HammerSpoon。别怕，这是正常操作。
### 基础使用教程：从零开始写第一个脚本
配置文件默认是空的。咱们先来点实用的。打开 `init.lua`，把下面这段粘进去，然后保存。
```lua
-- 重新加载配置
hs.hotkey.bind({"cmd", "alt"}, "R", function()
hs.reload()
hs.notify.new({title="Hammerspoon", informativeText="配置已重载"}):send()
end)
```
这段代码的意思是：按 `Cmd + Alt + R`，重新加载配置文件，并弹个通知告诉你成功了。这个快捷键一定要先设好，因为你后面每次改配置，都要靠它生效。
接下来，最经典的功能——**窗口管理**。把下面代码加到配置文件里：
```lua
-- 窗口管理：把当前窗口移动到屏幕左半部分
hs.hotkey.bind({"alt", "ctrl"}, "Left", function()
local win = hs.window.focusedWindow()
local frame = win:screen():frame()
win:setFrame(hs.geometry.rect(frame.x, frame.y, frame.w / 2, frame.h))
end)
-- 右半部分
hs.hotkey.bind({"alt", "ctrl"}, "Right", function()
local win = hs.window.focusedWindow()
local frame = win:screen():frame()
win:setFrame(hs.geometry.rect(frame.x + frame.w / 2, frame.y, frame.w / 2, frame.h))
end)
```
保存后，按 `Cmd + Alt + R` 重载。现在随便开个窗口，按 `Ctrl + Alt + Left`，窗口就会贴到屏幕左边。是不是比系统自带的爽多了？你可以自己加“上、下、最大化、居中”等一堆。
### 进阶技巧：让工具自己“思考”
基础用法是“你按快捷键，它执行动作”。进阶玩法是“它根据环境，自动执行动作”。这才能体现 Hammerspoon 的威力。
**场景一：自动切换输入法**
我写代码用英文输入法，聊天用中文。以前每次切窗口都要手动换，烦死。现在用 Hammerspoon 监听应用切换：
```lua
-- 监听应用切换，自动切换输入法
hs.application.watcher.new(function(appName, eventType)
if eventType == hs.application.watcher.activated then
if appName == "Code" or appName == "Terminal" or appName == "iTerm2" then
hs.keycodes.currentSourceID("com.apple.keylayout.ABC") -- 切到英文
elseif appName == "WeChat" or appName == "QQ" or appName == "Safari" then
hs.keycodes.currentSourceID("com.apple.inputmethod.SCIM.ITABC") -- 切到中文
end
end
end):start()
```
把 `com.apple.keylayout.ABC` 换成你自己的英文输入法 ID，中文那个换成你的中文输入法 ID（在“系统设置 -> 键盘 -> 输入法”里能看到）。从此以后，我打开 VSCode 自动英文，打开微信自动中文，彻底告别手动切换。
**场景二：外接显示器断连自动重排窗口**
我经常拔掉外接显示器，所有窗口全挤到 MacBook 的小屏幕上，乱成一团。用 Hammerspoon 监听显示器变化：
```lua
local function rearrangeWindows()
local screens = hs.screen.allScreens()
if #screens == 1 then
-- 只有内置屏幕时，把当前所有窗口最大化
for _, win in pairs(hs.window.allWindows()) do
win:maximize()
end
end
end
hs.screen.watcher.new(rearrangeWindows):start()
```
这样拔掉显示器后，所有窗口自动最大化，不会出现窗口跑到屏幕外找不到的情况。
**场景三：剪贴板历史**
macOS 自带剪贴板只能存一条，太痛苦。Hammerspoon 可以用 `hs.pasteboard` 做一个简易历史：
```lua
local history = {}
local maxHistory = 20
hs.hotkey.bind({"cmd", "shift"}, "V", function()
local pb = hs.pasteboard.getContents()
if pb and pb ~= history[#history] then
table.insert(history, pb)
if #history > maxHistory then table.remove(history, 1) end
end
hs.alert.show("剪贴板已保存")
end)
hs.hotkey.bind({"alt", "shift"}, "V", function()
if #history == 0 then return end
local last = table.remove(history)
hs.pasteboard.setContents(last)
hs.eventtap.keyStroke({"cmd"}, "V")
end)
```
按 `Cmd + Shift + V` 保存当前剪贴板内容，按 `Alt + Shift + V` 粘贴上一次保存的内容。虽然简陋，但够用，而且完全可控。
### 最后说点掏心窝子的
Hammerspoon 的生态很成熟，官方文档写得很好，还有大量现成配置可以抄（GitHub 搜 `awesome-hammerspoon`）。它的学习曲线不陡，只要懂一点编程基础（哪怕只会复制粘贴），就能玩出花来。
它唯一的缺点就是：**太折腾了**。如果你只想“装好就完事”，那建议直接买 Magnet 或 Rectangle。但如果你享受“驯服系统”的快感，享受自己写代码解决痛点的成就感，那 Hammerspoon 就是你的终极玩具。
我从最开始只会复制别人的配置，到现在自己写了几百行 Lua 脚本，管理着窗口、输入法、显示器、剪贴板、甚至定时提醒喝水。它让我的 Mac 真正变成了“我的” Mac。强烈建议你今晚就装上，从改一个快捷键开始，你会发现新世界的大门。
对了，记住保存配置后按 `Cmd + Alt + R` 重载，这步忘了会怀疑人生。祝玩得开心。