切到副屏，鼠标却还留在主屏：我的 Hammerspoon 配置（应用秒切 + 鼠标跟屏 + 快捷键速查）

桌上加了块副屏之后，有个小毛病天天犯。

⌘Tab 切到副屏的 Chrome ，窗口是亮了，鼠标还在主屏待着。这时候手一滚滚轮，滚的是鼠标底下那个 iTerm ，副屏的 Chrome 一动不动。愣半秒反应过来，去摸鼠标，甩过去，再滚。一天几十回。

这事 Raycast 、Rectangle 都解决不了，它们管窗口，不管鼠标。最后是用 Hammerspoon 缝了段逻辑：按快捷键切应用的时候，鼠标自己飞到目标窗口中间。顺手把之前乱七八糟的应用快捷键也重排了一遍。

之前写过一篇入门配置（把 Mac 变成键盘流神器），这篇是续集。完整配置放在最后，改改 apps 表就能用。

没装过的话：brew install --cask hammerspoon，然后去系统设置的辅助功能里给它打勾，配置文件是 ~/.hammerspoon/init.lua。

先说说 Hammerspoon 到底能干什么

很多人以为它就是个"配快捷键的工具"，其实那只是最表层的用法。它本质是把 macOS 的一大堆系统 API 包成了 Lua，你能拿到的东西比想象中多得多：

窗口和屏幕：

• hs.window 移动、缩放、聚焦任意窗口，不限于前台


• hs.grid 把屏幕切成网格，窗口按格子吸附


• hs.layout 一次性把多个应用摆成预设布局


• hs.screen 多显示器的位置、分辨率，甚至能调色温（内置夜览）


• hs.spaces 控制 macOS 的"桌面/空间"切换

应用和输入：

• hs.application 启动、聚焦、查窗口，还能直接点应用的菜单项（能把没有快捷键的菜单功能绑上键）


• hs.eventtap 拦截和改写键盘鼠标事件，键位重映射、鼠标手势都是在这层做


• hs.hotkey.modal 模态快捷键，按一个前缀键进入一层"子键位"，Vim 那套思路


• hs.pasteboard 读写剪贴板，做剪贴板历史、自动去格式

系统状态监听，这块是我觉得真正拉开差距的地方，因为它是事件驱动，你不按键它也在替你干活：

• hs.wifi.watcher 换 WiFi 时触发。到公司自动静音、回家自动连蓝牙音箱


• hs.usb.watcher 插拔 USB 设备时触发。插上键盘自动切输入法、插上硬盘自动跑备份


• hs.screen.watcher 接上或拔掉外接显示器时触发，自动重排窗口布局


• hs.battery.watcher 电量、充电状态变化时触发


• hs.caffeinate 控制休眠、锁屏，也能监听睡眠/唤醒事件


• hs.pathwatcher 盯着某个目录，文件一变就执行脚本


• hs.audiodevice 音频设备切换和音量控制


• hs.application.watcher 应用启动、退出、切到前台时触发

界面这块也不用自己写：

• hs.chooser 一个 Alfred 风格的搜索框，数据你自己喂，做个人版启动器很方便


• hs.menubar 往菜单栏塞图标和菜单


• hs.alert 屏幕中央的半透明提示，我的速查表就是它


• hs.notify 系统通知中心的正经通知


• hs.drawing / hs.canvas 直接往屏幕上画东西

最后是"它其实是个完整运行时"这一面：

• hs.task 后台跑外部命令并拿到输出，不阻塞主线程


• hs.http 发 HTTP 请求，配 hs.json 直接对接 API


• hs.osascript 执行 AppleScript ，够不到的应用用它兜底


• hs.urlevent 注册自定义 URL scheme ，命令行或别的应用能反过来触发 Hammerspoon


• hs.timer.doAt 定点执行，比如每天下班时间弹个提醒


• 还有 Spoon 生态（社区打包好的功能模块），不想自己写可以直接装

所以它跟 Raycast 那类工具不是一个层面的东西。Raycast 给你的是做好的功能，Hammerspoon 给你的是一堆系统能力和一个 Lua 解释器，缺什么自己缝。代价当然是你得写代码。

下面是我实际在用的部分。

应用切换：⌥ + 首字母

我原来的键位是想到哪绑到哪：iTerm 是 ⌥T 、千问 ⌥E 、Qoder ⌥C 、飞书 ⌥Q 。看着挺全，实际每次按之前都要在脑子里过一遍"这个是哪个键来着"。要想一下的快捷键，等于没有。

后来干脆定死一条规则：⌥ 加应用名英文首字母，不许有例外，撞了才另说。

只撞了两回。Chrome 和 Claude 抢 C ，C 给了 Claude ，Chrome 用 Google 的 G （反正原来也是这么绑的）；千问和 Qoder 抢 Q ，Q 给千问，Qoder 走 Dev 的 D 。系统设置用逗号，跟 ⌘, 是一个意思。DBeaver 的 B 是 dataBase ，有点牵强，用两天也就记住了。

键位本身不重要，有条规则才重要，装新应用基本不用想往哪绑。

实现没有一条条 bind ，写成一张表加一个循环，加应用改一行：

local apps = {

  { key = "c", id = "com.anthropic.claudefordesktop", desc = "Claude" },

  { key = "g", id = "com.google.Chrome",              desc = "Chrome （ Google ）" },

  -- ...

}



for _, item in ipairs(apps) do

  hs.hotkey.bind({"option"}, item.key, function()

    focusApp(item.id)

  end)

end

表里用的是 bundle ID 不是应用名。因为显示名跟 .app 文件名经常对不上，iTerm.app 显示名叫 iTerm2 、LarkSuite.app 叫 Lark 、DBeaver.app 叫 DBeaver Community ，用名字匹配会查不到。

把本机所有应用的名字和 bundle ID 一次性列出来，照着抄就行：

for a in /Applications/*.app /System/Applications/*.app; do

  id=$(defaults read "$a/Contents/Info" CFBundleIdentifier 2>/dev/null)

  [ -n "$id" ] && printf '%-24s %s\n' "$(basename "$a" .app)" "$id"

done | sort

输出长这样：

Apifox                   cn.apifox.app

Claude                   com.anthropic.claudefordesktop

DBeaver                  org.jkiss.dbeaver.core.product

Google Chrome            com.google.Chrome

LarkSuite                com.larksuite.larkApp

上面列的是 .app 文件名。想看应用真正的显示名，在 Hammerspoon 控制台里跑这段，列出当前运行中的应用：

for _, app in ipairs(hs.application.runningApplications()) do

  print(app:name(), app:bundleID())

end

鼠标跟随

开头说的那个毛病，就靠这段治。要干的事两件：等应用真到前台，然后把鼠标挪到它窗口中间。

local FOLLOW_ACROSS_SCREENS_ONLY = true  -- 只在跨屏时移动鼠标

local FOCUS_WAIT = 1.5                   -- 冷启动最多等这么久



local function centerMouseOn(win)

  if not win then return end

  local target = win:screen()

  if not target then return end

  if FOLLOW_ACROSS_SCREENS_ONLY then

    local cur = hs.mouse.getCurrentScreen()

    if cur and cur:id() == target:id() then return end

  end

  hs.mouse.absolutePosition(win:frame().center)

end



local function focusApp(bundleID)

  hs.application.launchOrFocusByBundleID(bundleID)



  local function targetWindow()

    local app = hs.application.get(bundleID)

    if app and app:isFrontmost() then

      return app:focusedWindow() or app:mainWindow()

    end

  end



  local win = targetWindow()   -- 本来就在前台，立刻跟

  if win then

    centerMouseOn(win)

    return

  end



  -- launchOrFocus 是异步的，得等应用真到前台再读窗口，不然拿到的是你切换之前那个

  local deadline = hs.timer.secondsSinceEpoch() + FOCUS_WAIT

  hs.timer.waitUntil(

    function()

      return targetWindow() ~= nil or hs.timer.secondsSinceEpoch() > deadline

    end,

    function()

      centerMouseOn(targetWindow())

    end,

    0.05)

end

两个地方是试出来的。

一个是落点放窗口中心，不是屏幕中心。macOS 滚轮作用的是鼠标底下那个窗口，窗口要是没铺满屏幕，鼠标落在屏幕中心可能压根不在窗口上，滚轮照样不听话。

另一个是 FOLLOW_ACROSS_SCREENS_ONLY。同屏切来切去的时候也吸鼠标会很烦，光标一直被抢走，鼠标本来指着的位置全没了。所以默认只在跨屏时才动，想每次都吸把它改成 false 。

顺手加的几个

• ⌘⌃ 方向键：当前窗口贴上下左右半屏


• ⌘⌃F：把窗口甩到下一块屏，鼠标跟着过去


• ⌘⌃M：只把鼠标丢到下一块屏中间，窗口不动


• ⌘⌃/：弹出速查表


• ⌘⌃R：重载配置

⌘⌃M 是纯为多屏加的，找鼠标真的比想象中费时间。screen:next() 会绕回第一块，双屏就是来回切：

hs.hotkey.bind({"cmd", "ctrl"}, "M", function()

  local screen = hs.mouse.getCurrentScreen() or hs.screen.mainScreen()

  local target = screen:next()

  hs.mouse.absolutePosition(target:frame().center)

  hs.alert.show("鼠标已移至 " .. target:name(), 0.5)

end)

速查表是给自己擦屁股用的。配快捷键的人大概都经历过：配了二十个，真正常用三个，剩下的忘干净。⌘⌃/ 按下去屏幕中间列出当前所有绑定，因为绑定本身就是上面那张 apps 表，速查表是循环拼出来的，加应用不用两头改。

⌘⌃R 用 pcall 包一下 hs.reload 也建议加，语法写错了会直接弹窗告诉你哪行，不然配置静默不生效，能查半天。

完整配置

-- 安全重载：出错时弹窗提示

hs.hotkey.bind({"cmd", "ctrl"}, "R", function()

  local success, msg = pcall(hs.reload)

  if not success then

    hs.alert.show("❌ 配置错误:\n" .. tostring(msg))

  else

    hs.alert.show("✅ 配置已重载", 1)

  end

end)



-- 窗口半屏

local function moveWindowTo(rect)

  return function()

    local win = hs.window.focusedWindow()

    if win then win:move(rect, nil, true) end

  end

end



hs.hotkey.bind({"cmd", "ctrl"}, "Up",    moveWindowTo(hs.geometry.rect(0, 0, 1, 0.5)))

hs.hotkey.bind({"cmd", "ctrl"}, "Down",  moveWindowTo(hs.geometry.rect(0, 0.5, 1, 0.5)))

hs.hotkey.bind({"cmd", "ctrl"}, "Left",  moveWindowTo(hs.geometry.rect(0, 0, 0.5, 1)))

hs.hotkey.bind({"cmd", "ctrl"}, "Right", moveWindowTo(hs.geometry.rect(0.5, 0, 0.5, 1)))



-- 将窗口移到下一显示器

hs.hotkey.bind({"cmd", "ctrl"}, "F", function()

  local win = hs.window.focusedWindow()

  if win then

    win:moveToScreen(win:screen():next())

    hs.mouse.absolutePosition(win:screen():frame().center)

    hs.alert.show("窗口已移至下一屏幕", 1)

  end

end)



-- 将鼠标移到下一显示器中央

hs.hotkey.bind({"cmd", "ctrl"}, "M", function()

  local screen = hs.mouse.getCurrentScreen() or hs.screen.mainScreen()

  local target = screen:next()

  hs.mouse.absolutePosition(target:frame().center)

  hs.alert.show("鼠标已移至 " .. target:name(), 0.5)

end)



-- 快速打开 GitHub

hs.hotkey.bind({"cmd", "ctrl"}, "G", function()

  hs.urlevent.openURL("https://github.com")

end)



-- ========== 应用快捷键：⌥ + 名字首字母 ==========

-- 冲突处理：Chrome → G(oogle)，C 让给 Claude ； Qoder → D(ev)，Q 让给千问

-- 用 bundle ID 而不是应用名：显示名和文件名常对不上（ iTerm→iTerm2 、LarkSuite→Lark 、DBeaver→DBeaver Community ）

local apps = {

  { key = "c", id = "com.anthropic.claudefordesktop", desc = "Claude" },

  { key = "g", id = "com.google.Chrome",              desc = "Chrome （ Google ）" },

  { key = "s", id = "com.apple.Safari",               desc = "Safari" },

  { key = "i", id = "com.googlecode.iterm2",          desc = "iTerm2" },

  { key = "d", id = "com.aliyun.lingma.ide",          desc = "Qoder CN （ Dev ）" },

  { key = "a", id = "cn.apifox.app",                  desc = "Apifox" },

  { key = "q", id = "com.alibaba.tongyi",             desc = "千问 Qianwen" },

  { key = "w", id = "com.tencent.xinWeChat",          desc = "微信 WeChat" },

  { key = "f", id = "com.apple.finder",               desc = "Finder" },

  { key = ",", id = "com.apple.systempreferences",    desc = "系统设置" },

  { key = "b", id = "org.jkiss.dbeaver.core.product", desc = "DBeaver" },

  { key = "l", id = "com.larksuite.larkApp",          desc = "飞书 Lark" },

}



-- ---------- 切换应用时鼠标跟随到目标窗口 ----------

local FOLLOW_ACROSS_SCREENS_ONLY = true  -- true=只在跨屏时移动； false=每次切换都把鼠标放到窗口中央

local FOCUS_WAIT = 1.5                   -- 冷启动最多等待秒数



local function centerMouseOn(win)

  if not win then return end

  local target = win:screen()

  if not target then return end

  if FOLLOW_ACROSS_SCREENS_ONLY then

    local cur = hs.mouse.getCurrentScreen()

    if cur and cur:id() == target:id() then return end

  end

  hs.mouse.absolutePosition(win:frame().center)

end



local function focusApp(bundleID)

  hs.application.launchOrFocusByBundleID(bundleID)



  -- 目标应用真到前台后的窗口，没切过去就返回 nil

  local function targetWindow()

    local app = hs.application.get(bundleID)

    if app and app:isFrontmost() then

      return app:focusedWindow() or app:mainWindow()

    end

  end



  local win = targetWindow()

  if win then

    centerMouseOn(win)

    return

  end



  -- launchOrFocus 是异步的，轮询等激活/冷启动完成

  local deadline = hs.timer.secondsSinceEpoch() + FOCUS_WAIT

  hs.timer.waitUntil(

    function()

      return targetWindow() ~= nil or hs.timer.secondsSinceEpoch() > deadline

    end,

    function()

      centerMouseOn(targetWindow())

    end,

    0.05)

end



for _, item in ipairs(apps) do

  hs.hotkey.bind({"option"}, item.key, function()

    focusApp(item.id)

  end)

end



-- ⌘⌃/ 速查表，忘了就按它

hs.hotkey.bind({"cmd", "ctrl"}, "/", function()

  local lines = { "⌥ 切换应用（鼠标自动跟随）" }

  for _, item in ipairs(apps) do

    table.insert(lines, "⌥ " .. item.key .. "  →  " .. item.desc)

  end

  table.insert(lines, "")

  table.insert(lines, "⌘⌃ ←↑↓→  窗口半屏")

  table.insert(lines, "⌘⌃ F  窗口移到下一屏")

  table.insert(lines, "⌘⌃ M  鼠标移到下一屏中央")

  table.insert(lines, "⌘⌃ G  打开 GitHub")

  table.insert(lines, "⌘⌃ R  重载配置")

  hs.alert.closeAll()

  hs.alert.show(table.concat(lines, "\n"), 6)

end)



hs.alert.show("Hammerspoon 已加载！")

最后

上面这些其实只用到了 Hammerspoon 的一小部分，基本都还是"按键触发"这一类。真正有意思的是那些 watcher ，接显示器、插 USB 、换 WiFi 都能当触发条件，那部分我还没怎么动。

多屏的可以试试鼠标跟随这段，我个人是回不去了。不会写 Lua 代码的，复制这篇文章的链接，扔给 AI 参考帮写就行。