Mac Mouse Fix 指南：让 10 美元鼠标好过触控板-开发者社区

Mac Mouse Fix 指南：让 10 美元鼠标好过触控板

【免费下载链接】mac-mouse-fixMac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad!项目地址: https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix

Mac Mouse Fix 是一款开源的 macOS 鼠标增强工具，能把普通鼠标变成比 Apple 触控板还好用的输入设备：平滑滚动、手势模拟、按键自定义。这篇文章带你 5 分钟装好它，讲清每个能力怎么用、常见故障怎么排，最后顺带看懂它背后的双进程架构。

5 分钟装好，先把滚轮调丝滑

安装只有两条路。第一条：去项目官网下载最新安装包，拖进"应用程序"文件夹。第二条更省事，在终端里一行命令搞定：

brew install mac-mouse-fix

之后想升级就执行brew upgrade mac-mouse-fix。需要历史版本的话，到项目的 Releases 页面下载对应安装包。

首次启动时系统会要求授予**辅助功能（Accessibility）**权限——这是拦截鼠标事件的前提，对应检查逻辑在 AccessibilityCheck.m，主界面里的授权视图是 AuthorizeAccessibilityView.m。授完权打开设置，建议先过一遍滚轮参数：smooth（平滑度）默认high，speed（速度）默认medium，reverseDirection（反转方向）与trackpadSimulation（触控板模拟）默认开启。这些出厂值都写在 default_config.plist 里，想一键回退用界面里的 Restore Defaults 即可。

注意：Mac 是 Apple Silicon（M 系列芯片）还是 Intel 都可以放心装，官方确认其在 Apple Silicon 上 100% 原生运行，不走 Rosetta 转译。

把每个按键都安排上：单击、长按、双击的三级玩法

打开 Buttons 标签页，把鼠标指针移进顶部带 "+" 的捕获区，然后按下鼠标上的任意按键，Mac Mouse Fix 就开始记录它了——这就是"捕获（capture）"。

图：Buttons 标签页，为每个鼠标按键分配 Click、Click and Drag 等动作

💡 它的设计精髓在多级触发：同一个按键的单击（click）、长按（hold）、双击（doubleClick）各自是独立触发器，再叠加"层级（level）"区分第一级、第二级动作。出厂配置里的defaultRemaps映射表正是这套模型的示范——三键鼠标的中键单击绑定符号热键 70、长按绑定热键 36，五键鼠标则能把 Button 5 的拖拽直接变成双指滑动。

两个立刻能用的组合：

把亮度、音量、媒体键搬到鼠标上：Mac Mouse Fix 允许把键盘上任意按键绑到鼠标按键，包括只有 Apple 键盘才有的亮度、音量、媒体播放键。手边没有 Apple 键盘时，在按键选择器里按住 Option（⌥）就能选到这些特殊键。

图：官方演示动图——鼠标按键触发亮度/音量/媒体控制

注意：被捕获的按键等于被 Mac Mouse Fix 接管，其他应用将看不到它。如果某个软件依赖原生按键行为（例如 3D 软件里中键拖动旋转视角），把该按键的全部动作删掉即可"释放"它，官方在 CapturedButtonsMMF3.md 里有专门说明。另外两类鼠标要留意：专为厂商驱动（如 Logitech Options）设计的鼠标走私有协议，部分按键目前识别不全；Apple Magic Mouse 则完全不受影响，官方计划未来增强但暂无时间表。

窗口吸附、桌面切换：把触控板手势搬到鼠标上

Mac Mouse Fix 最能打的场景是手势模拟。核心操作：把某个按键的Click and Drag（点击并拖动）动作设为Scroll & Navigate（滚动与导航），从此"按住该键拖动鼠标"就等于在触控板上双指滑动。搭配 Swish 这类窗口管理工具时收益最大：

窗口吸附：按住已配置的按键往屏幕边缘拖，窗口即可吸附到半屏、四分之一屏或全屏，与触控板双指滑动的效果一致
Mission Control：选 Spaces & Mission Control 动作后向上拖（对应触控板双指上滑）
App Exposé：同一动作向下拖。若没反应，多半是系统层面禁用了该触控板手势——在系统设置里开启，或直接在终端执行：

defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock

实现路径大致是：拖拽输入先由 ModifiedDrag.m 统一分发，TwoFingerSwipe、ThreeFingerSwipe等子模块把鼠标轨迹翻译为多指滑动，最后由 TouchSimulator.m 合成真实的触控板事件发给系统。

上手后最容易撞的 6 个坑

点击有延迟：这是有意为之——单击之后它要短暂等待，判断你会不会接着双击（判定逻辑在 ClickCycle.swift）。不想要延迟的按键，把它的 Double Click 动作删光即可。
想要"按应用区分设置"：MMF 2 在More... > App-specific settings中可以按应用禁用平滑滚动等功能；MMF 3 尚未实现，官方未给出时间表。过渡方案：在General标签页打开Show in Menu Bar，之后能从菜单栏一键临时关掉滚动/按键功能。
倾斜滚轮能干嘛：支持用它横向滚动，且手感更自然更好控；但无法用它触发切桌面等其他动作——那需要重编程鼠标固件改发按键信号，官方明确短期内不会做。
指针加速关不掉：应用自身不提供开关。macOS 14 Sonoma 及更新系统可在系统设置 > 鼠标 > 高级... > 指针加速中关闭；官方计划未来提供更好的方案。
某些按键识别不到：多数是厂商私有协议鼠标（见上一节），属已知限制，先确认鼠标是否依赖专有驱动。
老系统装不上或界面错乱：按下一节的版本选择来装。

老系统怎么选版本，授权与隐私怎么算

版本选择按你的 macOS 来：

macOS 11 Big Sur 及更新：直接用最新 3.x，这是官方目标平台
macOS 10.15 Catalina / 10.14 Mojave / 10.13 High Sierra：建议用 Mac Mouse Fix 2 最新版；3.0.0 及以后可能仍能运行，但会有界面显示问题，部分功能可能异常
macOS 10.12 Sierra / 10.11 El Capitan：只能用 2.2.0 或更早版本

授权与隐私方面：MMF 2 完全免费且官方承诺持续维护；MMF 3 免费试用 30 天，之后付费购买。一份许可证覆盖你名下的所有 Mac，登录同一 Apple 账户时还会经 iCloud 自动同步到其他设备；授权范围是全部 3.x 版本，未来的 4.0 可能需要重新购买。没有官方退款政策，但有 30 天免费期兜底，购买后有问题可直接联系作者。应用本身无广告、不收集个人信息；唯一例外是购买环节由销售平台 Gumroad 收集邮箱等信息（用于退款、发送授权码），这一环节无法关闭。项目仍保持开源，遵循仓库 License 中的 MMF License。

卸载很简单：把应用拖进废纸篓即可，但系统里会残留配置文件。由于 macOS 不允许应用在删除时自行清理这些文件，官方推荐配合 AppCleaner（FreeMacSoft 出品）一类工具彻底清理。残留主要来自两处：配置持久化的 plist（读写逻辑在 Config.m），以及许可证与试用状态所在的安全存储 SecureStorage.swift——手动删容易遗漏，这正是官方推荐 AppCleaner 的原因。

30 秒看懂架构：为什么关掉窗口功能还在

Mac Mouse Fix 是双进程设计：主 App 只负责设置界面，真正拦截和改写鼠标事件的是后台的Helper 进程。所以"Enable Mac Mouse Fix"开关打开后，关掉主窗口、甚至重启电脑，功能都照常生效——这也是你不需要把它设为登录项的原因。

事件入口在 GlobalEventTapThread.m：它维护一个专门的事件回调 RunLoop，所有鼠标事件的拦截与改写都经这条线程串行派发。平滑滚动的计算集中在Helper/Core/Scroll/目录（Scroll.m、ScrollControl.m、ScrollAnalyzer.m），亮度、音量这类系统级功能键则由 SymbolicHotKeys.m 通过符号热键机制触发。想快速摸清整个功能面，读一遍 default_config.plist 即可：Scroll分组的smooth/speed/reverseDirection/trackpadSimulation管滚动，Pointer分组的acceleration/sensitivity/useSystemAcceleration管指针，General分组的buttonKillSwitch与scrollKillSwitch是两大功能的总开关，defaultRemaps则是按键映射的出厂预设。