Mac Mouse Fix 使用指南：10分钟完成 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 鼠标增强工具，接管鼠标侧键与滚轮：把侧键映射到启动台、调度中心等系统功能，让滚轮获得类似触控板的平滑滚动。下文按安装、授权、按键映射的顺序走完全部步骤。
项目定位
Mac Mouse Fix 代码完全开源，采用基于 MIT/BSD 的自定义 MMF 许可，可以直接阅读源码并自行编译。Mac Mouse Fix 2 及以下版本永久免费，3 版提供 30 天免费试用，之后支付少量费用即可解锁。它要求 macOS 11 Big Sur 及以上，Apple Silicon 上为原生运行。核心价值有两点：平滑滚动和按钮映射系统。它不依赖任何鼠标的品牌驱动，绝大多数 USB 和蓝牙鼠标接上就能用。
安装与首次运行
三种获取方式，任选其一：
- 普通用户：从官方渠道下载预编译安装器，直接拖进"应用程序"文件夹。
- Homebrew 用户：在终端执行
brew install mac-mouse-fix。 - 开发者：
git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix，然后用 Xcode 打开 Mouse Fix.xcodeproj 编译运行。
启动后按这个顺序操作：
- 打开应用，进入"通用"标签页，打开"启用 Mac Mouse Fix"开关。
- 系统会请求"辅助功能"权限，按提示在"系统设置 → 隐私与安全性 → 辅助功能"中勾选应用；若系统同时请求"输入监控"权限，一并允许。
- 重启应用。此时后台的"Mac Mouse Fix Helper"进程开始接管鼠标事件，主窗口之后随时可以关闭，效果持续。
授权之后第一步做什么：切到"按键"标签页，完成下面第一个演示，验证整条链路已经打通。
🖱️ 核心功能逐个演示
把侧键映射到系统功能
macOS 对第三方鼠标的侧键基本无感，MMF 会拦截这些按键并让它们执行任意动作。
- 点击顶部标签栏的"按键"（通用 / 按键 / 滚动 / 关于）。
- 把鼠标指针移入界面中央的大"+"区域内，然后真实按下要映射的那个鼠标按键。按键名称会出现在下方列表，同时弹出"按键 X 被 Mac Mouse Fix 捕获到"的提示。
- 在新增的动作行里选择触发方式（点按、双击、点按并拖动），再从右侧下拉框选具体功能：智能缩放、启动台、调度中心，或任意键盘快捷键、系统快捷键。
同一个按键可以挂多行动作，删掉某一行就解除该行为的捕获。映射逻辑在 按键映射实现 中。
调出平滑滚动
传统滚轮一格一格地跳，平滑滚动让它连续且带惯性。
- 点击"滚动"标签页。
- 在"平滑"下拉框里选低、中、高，选"关闭"则回到系统原生行为。
- 按需勾选"反转方向"（自然滚动），调整"速度"，并设置修饰键：按住 Command 横向滚动、按住 Shift 精确滚动。
点按并拖动模拟两指手势
按住某个按键再移动鼠标，等价于在触控板上双指滑动。
- 在"按键"标签页给某个按键添加"点按并拖动"这一行动作。
- 动作下拉框选"滚动与导航"。
- 使用中：按住该键左右拖动可切换桌面，向下拖动打开应用窗口（App Exposé）。
🧩 可抄作业的配置方案
三套按键映射，照抄进"按键"标签页即可。括号里标注适用软件。
| 按键 | 设计（Photoshop、Figma） | 开发（VS Code、Xcode） | 日常办公（浏览器、PDF） |
|---|---|---|---|
| 左侧键 | 点按：智能缩放；点按并拖动：滚动与导航 | 点按：启动台；双击：Mission Control | 点按：启动台 |
| 右侧键 | 点按：调度中心 | 点按：Mission Control | 点按：调度中心 |
| 中键 | 点按并拖动：滚动与导航（画布平移） | 点按并拖动：滚动与导航（窗口贴边） | 点按：智能缩放 |
只有三个按键的鼠标没有侧键，可以用"点按按键 5 + 点按中键"这类按键组合替代，默认配置里就有这种示例。
⚙️ 进阶能力
映射下拉框支持组合触发：修饰键、其他按键、连按次数都可以叠进来。选快捷键时按住 Option 还能调出 Apple 键盘特有的特殊键——亮度、音量、媒体播放，即使手上是普通键盘也能用鼠标触发。
原理速览
应用分两个进程：主 App 只负责界面，真正干活的是后台的"Mac Mouse Fix Helper"。开启开关后 Helper 常驻，所以关掉主窗口、甚至重启电脑后鼠标效果都在。
Helper 通过全局事件钩子拿到滚轮和按键的原始事件。滚动模块（滚动实现）用两级指数平滑处理：预测值由当前输入和上一时刻的趋势共同决定，输出不再受滚轮物理格数限制，松手后还会按衰减趋势补完剩余滚动量，这就是"惯性"的来源。
配置存在本地的 plist 里，默认值见 default_config.plist，按 Scroll / Pointer / Remaps / General 分段。每个按键动作都是"触发器 + 效果"对：触发器记录是哪个按键、哪种触发方式，效果指向一个系统快捷键或触控板手势。
🛠️ 排障手册
症状：映射后按键没反应。原因：按键其实没被捕获，或"通用"页的启用开关是关的。 解法：把指针移回"+"区域重新真实按一次该按键，看到"被捕获到"提示再继续；确认 Helper 进程在运行。
症状：点击出现明显延迟。原因：该按键挂了"双击"动作，MMF 每次单击都要等系统双击窗口期，才能判定是单击还是双击。 解法：删掉该按键的双击动作，延迟立即消失。
症状：某些侧键在列表里根本不出现。原因：部分鼠标（常见于罗技）只通过官方驱动的私有协议上报侧键，系统层看不到。 解法：先卸载官方驱动软件再试；深度绑定私有协议的型号属于已知局限。
症状：点按并拖动无法打开 App Exposé。原因：系统"应用窗口"触控板手势被关掉了。 解法：终端执行下面命令后重开 Dock：
defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock症状：滚动方向和预期相反。原因：默认启用了自然滚动方向。 解法：在"滚动"标签页切换"反转方向"勾选状态。
项目的贡献方式（反馈、翻译、代码）与已有贡献者名单见 Acknowledgements.md。仓库地址：git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix。
【免费下载链接】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），仅供参考
