Mac Mouse Fix 指南：10 美元鼠标也能调出 Trackpad 手感

【免费下载链接】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 鼠标增强工具：它在系统事件层截住滚轮和按键输入，再重新翻译成触控板级的平滑滚动、双指手势和键盘事件。

Mac Mouse Fix 安装授权与首条侧键配置：一条 brew 命令起步

从装到用惯，最快几分钟。先确认你该装哪条版本线：

两条线的商业规则不一样：MMF 2 永久免费且持续维护；MMF 3 有 30 天免费试用，之后花几美元买下——一份许可证在你名下所有 Mac 上有效，同一 Apple 账户登录时经 iCloud 自动同步，覆盖全部 3.x 版本。

安装只需要一条命令：

brew install mac-mouse-fix

从启动台打开应用，系统会提示你去系统设置 → 隐私与安全性 → 辅助功能勾选权限（没有这个权限，它既看不到也改不了任何鼠标输入）。授权后回到应用，打开General标签页的Enable Mac Mouse Fix开关。

⚠️ 这里有个新手最容易懵的点：开关打开后，关掉应用窗口、重启电脑，增强效果都还在。真正干活的是常驻后台的 Helper 进程，不是你眼前的窗口，所以完全不需要把它加进登录项。

首条配置：进Buttons标签页，把鼠标指针移进顶部的大 "+" 区域，直接按一下鼠标侧键，左侧列表会多出一条记录，在右侧下拉里选Back。侧键单击 = 浏览器后退，第一套配置就位。顺手在General里打开Show in Menu Bar，日后某个应用和增强打架时，菜单栏点一下就能临时关掉滚轮或按键。

平滑滚动、侧键绑 Back、手势模拟：装完当天会点到的三个开关 🖱️

先说最改变生活的一个。

**平滑滚动。**①Scrolling标签页保持默认就能直接吃：平滑度 High、速度 Medium、方向反转打开。② 体感上的变化：滚轮每一下输入不再直接变成页面位移，而是驱动一段带加速度的缓动——不再咔咔跳，而是带一点惯性滑过去。平滑度拉满时，它甚至把滚动事件改写为触控板语义，应用层"以为"你在用触控板。③ 想再拧细一点：给键盘修饰键绑定修饰功能，按住某键滚动即切换横向滚动、精准滚动、快速滚动或缩放（参数在modifiers下）。

源码印证：Helper/Core/Config/ScrollConfig.swift

**侧键重映射。**① 还是 Buttons 标签页：指针移进 "+" 区域，按哪个键就捕获哪个键；右侧动作列表里除了 Back / Forward / Mission Control，还有键盘上任意键——选不到亮度、音量这类 Apple 特殊键时，按住 Option（⌥）再选，它们就会出现在候选里。② 体感：按一下侧键切歌、调亮度，不用再伸手够 F 键区。③ 每条记录都是"触发方式 × 动作"的组合，Click、Double Click、Click and Drag、Hold 四种触发可以叠加在同一按键上。

源码印证：Helper/Core/Buttons/

**触控板手势模拟。**① 给某个按键（比如 Button 4）的Click and Drag触发器选Scroll & Navigate：配合 Swish 这类窗口管理器可以一键吸附半屏/四分之一屏，Blender 里按住拖拽就是环绕视角。② 体感：按住拖拽的瞬间，像有两根手指在触控板上滑——三指切桌面、Dock 相关手势这类"触控板能做的"，它都能复现。③ 想更稳：General里打开lockPointerDuringDrag，手势拖拽期间指针原地冻结，不会跟着跑偏。

源码印证：Helper/Core/Drag/

滚动参数速查：Scroll 配置键默认值与联动关系

最常动到的参数都挂在Scroll键下，默认值一览：

几个联动关系值得记住：speed选system时，加速算法完全不归它管，直接用 macOS 给的数值；smooth每降一档曲线就换一种——off无动画、low极低惯性、regular低惯性、high高惯性，再叠加触控板模拟就是最高一档的手感；四组modifiers掩码则是"按住对应按键时滚轮归谁管"的开关。

指针是另一套独立子系统。Pointer.acceleration默认0.6875（0~1 的强度）、sensitivity默认1、useSystemAcceleration默认false——默认就跑它自建的加速度引擎，内部按 125Hz 基准轮询率、1000 基准 CPI 做了补偿，所以 250Hz 的鼠标不会"越急越飘"。这套补偿已实现但 UI 开关尚未开放；想直接关掉指针加速度，macOS 14 Sonoma 及以上走系统设置 → 鼠标 → 高级 → 指针加速度。

后台 Helper 进程截住鼠标事件的 5 个环节

真正"动"你鼠标的，不是你打开的那个窗口，而是常驻后台的 "Mac Mouse Fix Helper" 进程——入口在 Helper/main.m，主程序只管界面和配置。整条流水线五步：

1. 拦截：按键事件由 Helper/Core/Buttons/ButtonInputReceiver.m 挂的 HID 级事件 tap 截下，滚轮由 Helper/Core/Scroll/Scroll.m 的 tap 截下，都在专用线程上；被捕获的按键事件从此不再透传给系统。
2. 分析：滚动侧的 ScrollAnalyzer 测量 tick 间隔与速度；按键侧的 RemapsAnalyzer 按 Remaps 配置判断要不要等双击、长按超时。
3. 执行：按键动作按 Remaps 翻译成键盘事件、系统热键、中键语义点击等，经 CGEvent 注入，集中在 Helper/Core/Remap/Remap.m。
4. 输出：滚动按配置给出的曲线逐帧输出事件，双指/三指滑动等手势先翻译成触控板语义再交给系统。
5. 指针：Helper/Core/PointerSpeed/PointerSpeed.m 直接改写 Apple HID 驱动的加速度表。

商业侧一笔带过：MMF 3 的 30 天试用按"跨天才 +1"计数——重启应用、重启电脑、同一天反复用都不重复计，触控板使用不计入；许可证一份覆盖你名下所有 Mac，同账户经 iCloud 自动同步，无正式退款政策。项目无广告、不收集个人信息，商业化后依然开源（条款见仓库根的 License 文件，鼓励复用源码，但不要直接发布应用副本）。

单击延迟、前进后退失灵、卸载残留等 6 个症状的排查路径

单击明显延迟，像"钝"了一下根因：该按键上绑了 Double Click 动作，每次单击后 MMF 都要等一下判断你是不是要双击。 解法：Buttons 标签页删掉该按键的所有 Double Click 条目，延迟当场消失。

浏览器前进后退、中键粘贴突然没反应根因：这个按键被 MMF 捕获（capture）了——被捕获的按键只有 MMF 看得到，其他应用收不到事件。系统一般会弹一个提示：

判断标准：Buttons 标签页左侧列表里出现过的按键，都是被捕获的。三条恢复途径：一是在 MMF 内把原功能翻译回来——中键粘贴用 Middle Click 动作、前进后退用 Back / Forward、3D 环绕用 Scroll & Navigate；二是把该按键左侧全部条目点掉（"-"），解除捕获、完全恢复原生行为；三是直接关掉General里的 Enable Mac Mouse Fix，零干预。

向下拖拽触发不了 App Exposé根因：不是 MMF 的问题，是系统层 Trackpad 的 App Exposé 手势本身被关了。 解法：在系统设置里重新开启该手势，或终端执行：

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

鼠标上有些按键 MMF 根本不认识根因：鼠标走的是厂商专有协议（Logitech Options 那类驱动设计），不是标准 USB 协议，MMF 目前识别不全；Apple Magic Mouse 目前也不受 MMF 任何影响。 解法：装上直接试，这是最稳的确认方式；完整兼容需要大量逆向工作，短期内不会到来。

想要"按应用生效"的设置根因：MMF 3 还没有应用级设置（MMF 2 的More... > App-specific settings有），应用级与鼠标级设置都在规划中、无时间表。 解法：General打开 Show in Menu Bar，遇到不兼容应用时从菜单栏临时关掉滚轮或按键增强。

卸载后觉得不干净根因：应用拖进废纸篓只完成一半——沙盒机制下，配置与后台残留文件应用自己删不掉。 解法：用 AppCleaner 这类第三方清理工具做彻底卸载。

一句话定位与今天就能做的一步

Mac Mouse Fix = 事件拦截 + 语义化按键重映射 + 触控板级滚动引擎，三件事把 10 美元鼠标的体验拉到 Trackpad 的维度。

今天就做：brew install mac-mouse-fix，装完把侧键绑成 Back，滚轮用默认平滑配置跑一天，手感对上了再回来拧参数。

进阶阅读：Support/Support.md 下的按键捕获与滚轮捕获两篇指南，配合 Readme.md 的 Questions 部分，基本覆盖所有高频疑问。

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