Mac Mouse Fix 完整指南：如何把普通鼠标升级成 macOS 触控板级输入设备
【免费下载链接】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 触控板和高端旗舰鼠标更顺手。
安装 Mac Mouse Fix 前先确认你的系统版本
两条路都能拿到应用：
- 打开官方下载页，取最新版本安装包；
- 在终端执行 Homebrew 命令，一行装完：
brew install mac-mouse-fix需要旧版本（比如老系统）可以去项目的 Releases 页面按版本号下载。
装之前先对照下表确认你的系统能跑哪一代，装错代数的代价是界面错乱甚至功能失效：
| 系统版本 | 对应产品 |
|---|---|
| macOS 11 Big Sur 及以上 | Mac Mouse Fix 3.x（当前主线，Apple Silicon 原生） |
| macOS 10.13–10.15（High Sierra / Mojave / Catalina） | Mac Mouse Fix 2 最新版（3.0.0 及以后可能有显示问题，部分功能异常） |
| macOS 10.11–10.12（El Capitan / Sierra） | Mac Mouse Fix 2.2.0 及以下 |
平滑滚动档位怎么选：从一格格卡顿到惯性滑行
滚轮一格一格"咔咔"响是普通鼠标最显旧的地方。在 Scrolling 标签页打开 Smooth Scrolling，滚轮立刻变成惯性滑行，手感接近用手指推内容。
四档平滑度对应四套不同的惯性动画曲线，区别在于"松手后内容滑行多久才停"：
| 档位 | 行为 |
|---|---|
off | 关闭平滑，滚轮直接透传，无惯性 |
low | 极短惯性，最跟手，刻意牺牲流畅感换取控制力（此档还会关闭快速滚动加速） |
regular | 日常推荐：响应快、滑行短，扫描长文档不拖沓 |
high（默认） | 高惯性，最接近 Apple 触控板的滑行质感 |
几个随用随查的配置项：
Scroll.speed（默认medium）：滚轮灵敏度，可选system/low/medium/high。选system时完全交回 macOS 原生算法，不应用自己的加速曲线。Scroll.reverseDirection（默认true）：反向滚动开关。Scroll.trackpadSimulation（默认true）：触控板模拟。开启后，high档会额外发送与真触控板完全同构的滚动事件，让 Xcode、Dock 这类对触控板事件敏感的程序把你当触控板对待；关闭后只保留高惯性曲线本身。Scroll.precise（默认false）：精准滚动，适合逐行微调。Scroll.modifiers下的horizontal/zoom/swift/precise：给水平滚动、缩放、快速滚动、精准滚动各绑一个键盘修饰键，按住即可临时切换滚动模式。
速度档位背后是一条"输入速度 → 滚动距离"的加速曲线：手转得越快，每格滚轮带出的像素越多。拿high平滑档举例，代码里 minSens 取[60, 90, 150]、maxSens 取[120, 180, 240]（单位像素/格），再按 low/medium/high 速度档位线性插值。连续快速甩轮还会触发快速滚动（fast scroll）加速——regular/high档约 2~3 次快速甩轮后起效、指数加速最高 7.5 倍，off档则放宽到 6 次、上限 3 倍，low档干脆关掉，保证手感线性可控。
曲线与参数的完整定义在 ScrollConfig.swift，每档的贝塞尔控制点、拖拽系数（dragExponent / dragCoefficient / stopSpeed，控制减速阶段的物理感）都写在animationCurveParamsMap里。
一个按钮模拟三指、四指触控板手势
想切换桌面、打开 Launchpad、捏合缩放？这些在触控板上靠手指，在 Mac Mouse Fix 里靠鼠标侧键。首次启动时，应用会按你的鼠标按键数自动套用一套预设模板（三键或五键），存在配置的Constants.defaultRemaps里。
三键鼠标（以中键为例）的默认模板：
- 单击中键 → 系统级快捷键（快捷键变体 70）；
- 长按中键 → 系统级快捷键（变体 36）；
- 双击中键 → 系统级快捷键（变体 160）；
- 按住中键并拖拽 → 模拟三指滑动（配合
dragTrigger触发）。
五键鼠标在此基础上多出两条侧键通道：一条侧键单击可触发 Launchpad、滚动时叠加四指捏合、拖拽触发三指滑动；另一条侧键单击触发 Smart Zoom、滚动时叠加缩放、拖拽触发两指滑动。变体 70 / 36 / 160 对应的正是 Launchpad、Mission Control、Dock 这类系统级动作。
模板只是起点，每个重映射项都由三段拼成，看懂这三段就能改任何按钮：
- trigger（触发）：
button（按键号）+duration（click单击 /hold长按）+level（单击层数），也支持dragTrigger（按住拖拽）、scrollTrigger（滚动时）这类特殊触发； - effect（动作）：
symbolicHotkey（系统快捷键，variant填编号）、smartZoom、modifiedDragType（threeFingerSwipe/twoFingerSwipe等拖拽手势）、modifiedScrollEffectModification（fourFingerPinch/zoom等滚动叠加效果）； - modifiers（附加条件）：如
buttonModifiers——必须同时按住另一按钮才生效。
以"按住中键拖拽 → 三指滑动"为例：trigger 是dragTrigger，effect 是modifiedDragType: threeFingerSwipe，modifiers 要求button 3处于按下状态。动作的最终执行入口是 Actions.h 里的executeActionArray:phase:：同一套动作按"按下 / 抬起 / 组合"三个阶段分别驱动，所以单击、长按、拖拽能各走各的。
一个小坑：重映射会给单击引入一点延迟，因为应用要等doubleClickThreshold（GeneralConfig.swift 中硬编码为 0.01 秒）确认你不会双击。介意的话，删掉该按钮上所有双击类动作即可。
双进程架构与 plist 配置：为什么关掉应用也生效
Mac Mouse Fix 是双进程设计，这是理解一切行为的钥匙：
- 主应用（App）：只做设置界面，App/ 下全部是 UI、更新和授权相关代码；
- Helper 进程：常驻后台，真正拦截并改写滚轮、按键、指针事件，核心模块集中在 Helper/Core/——
Scroll/处理滚动、Buttons/处理按键捕获、Actions/执行动作、Coordinate/输出合成事件、PointerSpeed/管指针速度、Config/存放各配置类的解析逻辑。
你在界面上打开 "Enable Mac Mouse Fix" 后，Helper 进程由 launchd 拉起并常驻。这意味着关掉应用窗口、甚至重启电脑，增强效果都还在——所以它不需要加进"登录项"。
所有设置以 key-path 字典形式存在 plist 里（模板见 default_config.plist），顶层键为Scroll/Pointer/General/Remaps/License/State/Constants。配置由 Config 单例统一读写；改完界面选项后 Helper 会立即重载对应配置类（如ScrollConfig.reload()）并切换曲线，无需重启。
指针（Pointer）配置值得单独说一句：Pointer.sensitivity（默认 1）、Pointer.acceleration（默认 0.6875，对应系统com.apple.mouse.scaling档位）、Pointer.useSystemAcceleration（默认false）。PointerConfig.swift 会把参数化加速度曲线直接写进 Apple 的 HID 指向驱动，并做两种补偿——轮询率补偿（以 125 Hz 为基准，轮询率指鼠标每秒向系统报告位置的次数）和 CPI 补偿（以 1000 CPI 为基准，CPI 即鼠标每移动一英寸报告多少个像素点）——让不同硬件的鼠标在相同设置下手感一致。这部分功能仍在迭代中。
General键里还有几个实用开关：showMenuBarItem（默认false，开启后菜单栏出现图标）、scrollKillSwitch/buttonKillSwitch（滚动/按键一键总开关，默认false）、checkForUpdates（默认true）、lockPointerDuringDrag（拖拽手势期间锁定指针，默认false）。
进阶玩法：窗口管理、键盘功能上鼠标、App Exposé
🪟用鼠标拖窗口，替代触控板双指滑窗前提：安装 Swish 这类窗口吸附工具（此技巧依赖 Swish 的双指滑窗能力）。把某个按钮的 "Click and Drag" 动作设成 'Scroll & Navigate'，之后按住该按钮拖窗口，就能把窗口甩到半屏、四分之一屏或全屏。原则是：触控板双指滑动能做的事，'Scroll & Navigate' 基本都能等价完成。
🎚️把亮度、音量、媒体播放绑到鼠标上重映射时可以直接选键盘上的任意键，包括只出现在 Apple 键盘上的亮度、音量、媒体功能键。手边没有 Apple 键盘也没关系：在按键选择器里按住 Option（⌥），这些特殊键就会显示出来供你挑选。
🖥️按住按钮向下拖，打开 App Exposé把某按钮的 "Click and Drag" 动作配成 'Spaces & Mission Control'，然后按住它向下拖，即可展开当前应用的所有窗口。没反应的话，多半是系统层面禁用了 App Exposé 触控板手势——去系统设置里打开它，或在终端执行：
defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock授权、费用与卸载一次说清
Mac Mouse Fix 2 及更早版本永久免费且继续维护；Mac Mouse Fix 3 提供 30 天免费试用，之后一次性付费，买断后不限期使用。一份授权覆盖你自己名下的所有 Mac，同一 Apple 账户登录时还会经 iCloud 自动同步过去——注意授权不能公开发布，分享给家人可以。它覆盖全部 3.x 版本，未来的 4.0 这类大版本可能要求重新购买。
退款没有正式政策，但 30 天试用本身就是缓冲；购买后遇到问题直接联系开发者即可。通过 PayPal 捐赠过的用户可申请免费授权。商业化没有改变开源属性：MMF 3 及以后继续遵循项目自己的 MMF License（见 License），鼓励你把源码用进自己的项目，只是别原样再发一份副本。
卸载很简单：把应用拖进废纸篓即可。但 macOS 不允许应用在自己被删时顺手清理残留，所以配置文件（前文提到的 plist，含全部配置与授权状态）会留在系统里，建议配合 AppCleaner 之类的工具彻底清掉。
常见疑问速查：系统门槛、功能行为、授权
使用门槛类
- Apple Silicon 原生吗？是，100% 原生运行。
- 我的鼠标支持吗？走标准协议的鼠标绝大多数没问题，最稳的办法就是装来试。例外是依赖厂商专有驱动协议（如 Logitech Options 那类）的鼠标，部分按键目前无法识别。
- Magic Mouse / 倾斜滚轮？Magic Mouse 目前不受任何影响，后续可能加增强；可倾斜滚轮的水平滚动会被处理得更自然，但暂时不能用倾斜触发切桌面等动作。
功能行为类
- 点击为什么有延迟？双击判定等待（0.01 秒）造成的，删掉该按钮上的双击动作即消失。
- 有按应用区分的设置（Profiles）吗？MMF 2 有，MMF 3 还在规划（应用级与鼠标级都在）。过渡方案：在
General页打开Show in Menu Bar，用菜单栏按钮临时禁用平滑滚动或按键重映射。 - 如何关掉指针加速度？应用内暂无开关；macOS 14 Sonoma 及以上可在 系统设置 → 鼠标 → 高级… 中关闭。更好的方案已在路上。
授权相关类
- 一台授权用几台机器？你自己的所有 Mac + 同账户 iCloud 同步。
- 覆盖哪些版本？全部 3.x；4.0 可能需重新购买。
- 会收集我的数据吗？应用无广告、不收集个人信息。唯一例外是购买环节：销售平台会保存你的邮箱等信息（用于发授权码与退款），这对开发者可见且无法关闭。
谁该用 Mac Mouse Fix，下一步往哪深挖
有普通鼠标但想要触控板级滚动、侧键多到无处安放、或者想把窗口管理和媒体控制都收进一只手里的用户，基本就是为目标人群。反向名单同样清楚：只依赖厂商专有协议的鼠标，或只用 Magic Mouse 的，暂时绕开它。
想往下挖的话，按这条线索走效率最高：ScrollConfig.swift 里每档曲线的贝塞尔参数与加速表，看"手感"是怎么被数值定义的；PointerConfig.swift 顶部的注释，讲清了轮询率与 CPI 补偿的推导过程；Actions.m 的动作分发，则是重映射从配置到执行的落点。想参与项目，提反馈、补翻译、发 PR 都行——方向拿不准时，先提一个只描述改动方案、几乎不含代码的 PR 让作者确认，能省掉大量返工。
【免费下载链接】mac-mouse-fixMac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad!项目地址: https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
