Mac Mouse Fix：用 macOS 鼠标按键映射，把 $10 的鼠标调得比触控板更好用-平芜编程栈

Mac Mouse Fix：用 macOS 鼠标按键映射，把 $10 的鼠标调得比触控板更好用

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

侧键按了没反应、滚轮一格飞半屏——这是大多数第三方鼠标在 macOS 上的日常。Mac Mouse Fix 针对这两个问题提供 macOS 鼠标按键映射与平滑滚动，让任意标准 USB 鼠标拥有接近触控板的输入体验。

好鼠标，为什么在 macOS 上会"废掉"

换掉苹果触控板、接上一把好鼠标的人，第一感受往往是落差。

改造前：

插上即按侧键，macOS 根本不认识这颗键，怎么按都没回音；
滚动是大段的：一格滚轮飞过去十几行，想精调位置，页面已经跳飞了；
五键鼠标上的中键、DPI 键、第五键，在 Mac 上全是摆设。

改造后：

侧键变成了"上一个/下一个标签页""切换 Mission Control""关闭当前标签页"；
滚轮变成触控板手感：慢转精确、快转带惯性，反向拨一格即可刹停；
按住侧键再拖拽，能模拟双指手势——把窗口推成半屏，或在 3D 软件里环绕物体。

同一只鼠标、同一双手，体验完全不同。差别不在鼠标，而在中间缺了那个"翻译层"。

它是什么，又凭什么能做到

Mac Mouse Fix 是一个 macOS 用户态鼠标驱动。它不装内核扩展，而是以Mac Mouse Fix Helper后台进程运行，在事件到达系统之前截获鼠标输入并改写。

它凭什么做到：靠的是辅助功能与输入监控两个标准系统权限，在用户态拦截并重写 HID 事件——不需要内核扩展，不需要额外签名。Apple Silicon 机器上 100% 原生运行。开启"启用 Mac Mouse Fix"开关后，Helper 进程接管鼠标事件，关掉主窗口甚至重启电脑都继续生效，无需添加登录项。

⚡ macOS 鼠标按键映射与平滑滚动：三个最高频能力

给任意按键换个新工作

单击、双击、长按、加修饰键、点按并拖移——任意组合都能绑定到几十个系统动作：Mission Control、启动台、媒体播放、音量、亮度，等等。比较有意思的一点是，它允许你从鼠标直接触发键盘上任意按键，包括只在苹果键盘上才有的特殊功能键；手上没有 Apple 键盘时，按住 Option（⌥）就能调出这些键的选择列表。

源码参考：按键映射核心

让滚轮拥有触控板手感

平滑滚动的核心是双指数平滑：低速时精确可控，高速时保持流畅惯性，并且可以反向拨一格滚轮刹停滚动（3.0.2 引入的 opposite-tick 机制）。滚动方向、灵敏度、平滑强度都可调。长文阅读和 Photoshop、Figma 里的微调场景，改善最直观。

源码参考：平滑滚动引擎

把鼠标变成手势设备

给任意按键的"点按并拖移"绑定 Scroll & Navigate 后，鼠标就能模拟双指滑动：配合窗口管理工具可以把窗口推到半屏或四分之一屏、打开启动台，3D 软件里也能环绕物体。触控板双指手势能做的事，它基本都能复刻。

源码参考：手势与拖拽模块

✅ Mac Mouse Fix 授权与绑定首键步骤

第一步：拿到应用。

git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix

用 Xcode 打开工程构建即可（最新版要求 macOS 11 Big Sur 及以上；Mac Mouse Fix 2 及更早版本可低至 10.11）。

第二步：授予两项权限。

系统设置 → 隐私与安全性 → 辅助功能：添加 Mac Mouse Fix；
系统设置 → 隐私与安全性 → 输入监控：添加 Mac Mouse Fix Helper。

第三步：打开主开关。启用 Mac Mouse Fix 后由后台 Helper 接管，不必再配置登录项。

第四步：绑定第一颗键。进入"按键"页，把鼠标指针移进顶部"+"区域，按下想绑定的按键，再选择动作即可；想解绑时，点该条目左侧的减号图标删除。

可照抄的 macOS 鼠标按键映射配置示例

办公流

{ "button_4": "上一个标签页", "button_5": "下一个标签页", "middle_click": "关闭标签页", "button_4_drag": "窗口半屏" }

适用软件：Safari、Arc、VS Code、Microsoft Office。高频导航与窗口管理全部移到鼠标侧键完成，左手不用再够键盘。

设计流

{ "middle_click": "智能缩放", "button_5_double": "切换调度中心", "button_4_drag": "滚动与导航" }

适用软件：Photoshop、Figma、Blender。"滚动与导航"让平移画布和 3D 环绕不再依赖键盘，省掉大量切窗口的操作。

和商用驱动软件放在一起看

对比维度	Mac Mouse Fix	常见商用驱动
权限要求	仅辅助功能 + 输入监控	常需额外驻留服务或内核扩展
滚动引擎	平滑滚动、惯性、曲线可调	多为固定档位或简单加速
兼容范围	绝大多数标准 USB 鼠标	通常只兼容自家品牌
授权类型	开源（MMF License），2 及更早版本永久免费	闭源，多数收费
Apple Silicon	100% 原生	因品牌而异