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 的开源鼠标驱动，核心能力是鼠标按键映射：它能把第三方鼠标的侧键绑成系统功能，模拟触控板双指手势，并把滚轮滚动修出惯性。代码完全开放，MMF2 永久免费，MMF3 前 30 天免费。如果你用着非苹果鼠标、对侧键失灵和滚动卡顿忍无可忍，它就是为你准备的。
🖱️ 它到底解决什么问题
花几百块买的游戏鼠标插到 Mac 上，往往只剩左键右键能用了：侧键按下去毫无反应，中键只能用来粘贴，滚轮一跳就是一大截。想呼出 Mission Control？没触控板。想双指横滑切桌面？更不可能。Mac Mouse Fix 就是来补上这块短板的，而且代码全部开源，想查逻辑随时可以翻。
🧰 核心能力全景
按键映射：把键盘上任意按键搬到你鼠标上
这是 Mac Mouse Fix 最核心的能力，让鼠标上每一个物理按键都去执行任意系统动作。多种触发方式：单击、双击、点按并拖移、点按并滚动，每种都能单独绑定不同动作。全系统功能：调度中心、启动台、智能缩放、切换桌面，甚至键盘上的任意按键（包括亮度和音量键）都能映射到鼠标上。通用前进后退：同一个侧键在不同应用里智能适配对应的"后退/前进"实现。核心逻辑在 Helper/Core/Buttons/。
平滑滚动引擎：滚轮从此不再一跳一跳
卡顿的机械滚轮会被重构成触控板式的连续滚动。平滑度分级：关闭、低、常规、高四档可选。惯性曲线：滚停后页面像触控板一样自然减速，而不是一下子刹住。触控板模拟：高档位下会直接生成触控板手势事件，为触控板优化过的应用能完整吃到效果。引擎实现见 Helper/Core/Scroll/。
指针速度与加速度：手感独立于系统调
指针的灵敏度与加速曲线由它单独接管，不跟系统设置打架。灵敏度调节：整体快慢随你喜好定。加速度曲线：低速精确、高速跟手，避免"指针冲过头"的常见毛病。相关源码在 Helper/Core/PointerSpeed/。
按键映射主界面：把指针移进"+"区域，点鼠标按键即可绑定动作，支持点按、点按并拖移等多种触发
⚙️ 安装与基础配置
- 安装：终端输入
brew install mac-mouse-fix；或者克隆源码用 Xcode 打开编译，成功后"应用程序"里会出现 Mac Mouse Fix。
git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix- 打开应用并打开总开关：启动后把 "Enable Mac Mouse Fix" 开关打开。后台 Helper 进程会接管鼠标，之后即使关掉窗口、重启电脑，映射依然生效，不需要设置登录项。
- 授予辅助功能权限：系统设置 → 隐私与安全性 → 辅助功能，勾选 Mac Mouse Fix。确认标志：开关不再弹权限提醒。
- 授予输入监控权限：系统设置 → 隐私与安全性 → 输入监控，勾选 Mac Mouse Fix。确认标志：侧键映射立即生效。
注意：MMF3 需要 macOS 11 Big Sur 及以上，老系统建议用永久免费的 MMF2。
🎯 实战配置：按角色给方案
程序员：让代码导航变成肌肉记忆
目标：文件、终端、浏览器之间来回切，手不用离开鼠标。
| 按键 | 触发方式 | 动作 |
|---|---|---|
| Button 4（前进侧键） | 点按 | 后退 |
| Button 5（后退侧键） | 点按 | 前进 |
| 中键 | 点按 | 智能缩放 |
VSCode、JetBrains 类编辑器里通用前进后退都能正常触发，日常通勤式的来回切换基本靠这两个侧键完成。
设计师：把设计软件里的鼠标操作对齐触控板习惯
目标：平移画布、缩放视图，操作逻辑和触控板一致。
| 按键 | 触发方式 | 动作 |
|---|---|---|
| 中键 | 点按并拖移 | 滚动与导航（模拟双指平移） |
| Button 4 | 点按并滚动 | 缩放（放大/缩小） |
| 中键 | 点按 | 智能缩放 |
适用 Photoshop、Figma、Blender 等。在 3D 软件里想绕着模型转视角时，把中键改成"滚动与导航"即可，不用再去够触控板。
内容创作者：切屏、切窗不松手
目标：直播和剪辑时多屏调度全靠鼠标，眼睛不看键盘。
| 按键 | 触发方式 | 动作 |
|---|---|---|
| Button 4 | 点按并拖移 | 切换桌面空间 |
| Button 5 | 点按并滚动 | 桌面与启动台 |
| 中键 | 双击 | 播放/暂停 |
配合菜单栏里的快速开关（见下图），录到一半遇到不兼容的应用，可以一键临时关掉某个功能，不用重进设置界面。
鼠标按键映射演示：按住 Option 还能选择亮度、音量这类 Apple 键盘专属按键
⚖️ 和别的方案放在一起看
| 维度 | Mac Mouse Fix | 商业鼠标驱动（如 SteerMouse） |
|---|---|---|
| 价格 | MMF2 永久免费，MMF3 免费 30 天后一次买断 | 一次性约 $30 |
| 源码 | 完全开源，逐行可查 | 闭源 |
| 滚动优化 | 多档平滑度 + 惯性曲线 + 触控板模拟 | 基础平滑 |
| 自定义深度 | 任意按键 + 任意触发组合 | 以预设动作为主 |
| 系统兼容 | macOS 11+（MMF3），更老系统有 MMF2 | 因版本而异 |
| 资源占用 | 轻量，闲置时 CPU 近乎为零 | 因驱动而异 |
商业驱动胜在品牌生态和自家硬件的深度支持，Mac Mouse Fix 则把"通用第三方鼠标能做到的上限"拉得很高，两者定位不同。
🔍 高频问题排查
侧键完全没反应
你遇到这个情况的话，试试这几步：
- 确认辅助功能和输入监控两个权限都勾上了（系统设置 → 隐私与安全性）。
- 退出并重新打开 Mac Mouse Fix。
- 拔插一次鼠标，再点按"启用"开关重新生效。
点按有一点点延迟
- 这通常是绑了"双击"动作导致的，系统会等一下确认你是不是要双击。
- 在按键标签页找到该按键，点减号删掉它的双击动作。
- 延迟立刻消失。
部分按键识别不到
- 罗技、雷蛇等部分型号走私有协议，系统层拿不到全部按键，这是设备限制。
- 换个通用协议型号（多数小品牌鼠标都是标准 USB HID），识别会完整得多。
- 仍不放心可以直接装上来试，支持情况以实测为准。
滚动还是不够顺滑
- 在滚动标签页把平滑度调到"高"。
- 想要最大控制感、线性手感就选"低"。
- 在个别游戏里若出现滚动异常，用菜单栏开关临时关掉平滑滚动即可。
点每行左侧的减号图标即可删除对应按键映射，把按键"还"给系统和游戏
✍️ 写在最后
Mac Mouse Fix 最值得记住的一点是：它没有替换你的鼠标，而是让普通鼠标做回触控板才能做的事——侧键调度系统、滚轮带惯性、拖移模拟双指。配置系统实现在 Shared/Config/，各标签页的界面逻辑在 App/UI/Main/Tabs/，想深挖细节可以直接从这两处读起。
喜欢就把它克隆下来，跑一次：git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix
核心关键词：鼠标按键映射
长尾关键词：macOS 鼠标设置、macOS 滚动平滑优化、第三方鼠标 macOS 兼容、鼠标侧键配置、触控板手势模拟
【免费下载链接】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），仅供参考
------第四篇 把IIC驱动重做一遍 基于stm32f103)
