Mac Mouse Fix 是 macOS 外接鼠标侧键映射最稳定开源方案:安装后授辅助功能与输入监控权限,通过「按键映射」页测试侧键编号(如 Button 4/5),支持单击、长按、拖拽等触发方式及启动台、Mission Control 等预设动作,还可绑定快捷键联动 Keyboard Maestro 实现宏操作。

MacBook外接鼠标侧键默认大多无功能或仅支持基础前进/后退,要真正用起来,得靠第三方工具做按键映射。系统原生设置几乎不支持侧键自定义,必须借助像 Mac Mouse Fix 这类轻量、开源、专为 macOS 优化的工具。
安装并启用 Mac Mouse Fix
这是目前最稳定、更新活跃、适配 macOS Sonoma/Ventura 的侧键配置方案:
- 前往官网(macmousefix.com)下载最新版,安装后在菜单栏点击图标启动
- 首次运行需在“系统设置 → 隐私与安全性 → 辅助功能”中勾选 Mac Mouse Fix
- 同时建议开启“输入监控”,否则组合键映射(如 ⌥+侧键)可能不生效
找到侧键编号并分配功能
多数鼠标侧键对应 Button 4(前进)和 Button 5(后退),但部分型号(如罗技 G304、雷蛇)需实测确认:
- 打开 Mac Mouse Fix 主界面,切换到「高级设置」→「按键映射」标签页
- 点击「测试按键」按钮,按压你的侧键,观察界面显示的 buttonIndex(例如显示 “Button 5”)
- 在对应编号下点击下拉菜单,选择预设动作:如「切换桌面」「Mission Control」「启动 Launchpad」「音量增大」「Siri」等
- 支持单键直连,也支持组合触发——比如设置「Button 5 + ⌘」为「聚焦访达」,避免误触
进阶:用宏实现系统原生不支持的操作
如果想让侧键执行多步操作(如「全屏当前应用 + 切换到桌面 2」),Mac Mouse Fix 本身不支持宏录制,此时可搭配辅助工具:
- 用 Keyboard Maestro 或 Hammerspoon 录制动作序列,再将该宏绑定到某个快捷键
- 回到 Mac Mouse Fix,把侧键映射为这个快捷键(例如 ⌘⌥F12)
- 注意:宏触发需确保 Keyboard Maestro 已授权辅助功能权限
常见问题处理
侧键没反应?先排查这几个点:
- 确认鼠标电池电量充足,蓝牙连接稳定(断连重连一次常能解决识别异常)
- 部分罗技鼠标需先用 Logi Options+ 关闭其自带侧键功能,否则会与 Mac Mouse Fix 冲突
- 雷蛇鼠标若从 Windows 导入配置,Win 键不会自动转为 Command 键,需手动改写宏中的按键码
- 重启 Mac Mouse Fix 或 macOS 后仍无效,可尝试在终端执行 killall "Mac Mouse Fix" 清除残留进程再重开


















