企业官网建设流程全解析

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

Mac Mouse Fix 是一款开源的 macOS 鼠标增强工具：给普通鼠标的侧键、中键分配系统动作，并把机械滚轮变成接近触控板的平滑滚动。它由主程序和后台 Helper 进程协作工作，Apple Silicon 原生支持。MMF 2 及更早版本永久免费，MMF 3 提供 30 天免费试用。适合想让鼠标侧键和滚轮真正派上用场的 macOS 用户。

项目速览

核心能力拆解：侧键映射、平滑滚动与按键捕获

🎯 智能按键映射：让侧键、中键各尽其用

把任意鼠标按键绑到系统动作上，触发方式支持点按、双击、长按、点按并拖移、点按并滚动，以及按键组合（如"点按按键 5 + 点按中键"）。动作库包括启动台、调度中心、智能缩放、前进/后退、中键点击，甚至能触发键盘上任意按键——按住 Option 还能选择亮度、音量、媒体控制这类 Apple 专用功能键。安装后自带一组默认映射（中键点按=智能缩放、按键 4 点按=启动台），不需要任何配置就能用。源码在 Helper/Core/Buttons/ 和 Helper/Core/Actions/。

如果你受够了"侧键在 macOS 上毫无用处"，这一节的功能就是为你准备的。

🌀 触控板级滚动：平滑引擎加双指手势模拟

滚动体验由两部分组成。一是滚轮平滑：Helper/Core/Smoothing/ 里的 DoubleExponentialSmoother 用双指数平滑算法处理滚轮步进，3.0.2 起还支持反向拨一格即停止滚动。二是"滚动与导航"（Scroll & Navigate）：点按并拖移某个按键即可模拟 Apple 触控板的双指滑动——切换桌面、打开启动台、在 Blender 里环绕模型，或配合 Swish 这类窗口管理工具拖拽窗口停靠到半屏、整屏，模拟逻辑在 Helper/Core/Touch/。

常看长文档、写代码、做 3D 的人，这部分收益最直接。

🖱️ 按键捕获机制：理解它，才不会被"失效"困扰

被 Mac Mouse Fix 绑定的按键对其他应用"不可见"，目的是防止你拖拽按键 4 切换桌面时同时触发浏览器后退。Buttons 标签页左栏列出的按键就是被捕获的；删掉某个按键的全部动作（点减号）即可释放，它立刻恢复原样。也可以在捕获状态下用"前进/后退""中键点击""滚动与导航"等动作恢复原有功能。官方文档在 Support/Guides/CapturedButtonsMMF3.md。

下一步：打开 Buttons 标签页，检查哪些按键正被捕获。

上手指南：三步完成安装与授权

1. 安装。终端执行 Homebrew 命令，或从源码构建：

brew install mac-mouse-fix

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

克隆后用 Xcode 打开Mouse Fix.xcodeproj构建 App 目标。

2. 授权辅助功能。系统设置 → 隐私与安全性 → 辅助功能，把Mac Mouse Fix Helper（不是主程序）加入并开启。部分按键录制功能可能还会要求输入监控权限。

   ⚠️ 易错点：如果 Helper 已在列表里却仍反复提示授权，先删除该条目，然后按住 Shift 点 Mac Mouse Fix 菜单栏图标在 Finder 中显示 Helper，再把它拖回辅助功能列表（见 Markdown/Templates/Support/Guides/Old/AccessibilityAccess.md）。个别 macOS 13/14 用户遇到后台进程注册问题，可按仓库内 Markdown/Templates/Support/Guides/Old/Enabling.md 执行sudo sfltool resetbtm后重启。

3. 开启并配置。打开主程序，打开"启用 Mac Mouse Fix"开关——之后由后台 Helper 接管鼠标，无需添加登录项。进入 Buttons 标签页，把指针移入"+"区域，按一下想配置的鼠标按键，再从下拉列表选动作即可。

三步走完，你的鼠标按键就已经在生效了。

场景配方：办公与 3D 设计的配置思路

办公/浏览器（适用：Safari、Chrome、VS Code、Office 全家桶）

• 按键 4 点按 → 后退；按键 5 点按 → 前进（该动作会模拟真实侧键事件，游戏内重映射依然可用）
• 中键 点按 → 中键点击（恢复打开链接、关闭标签页、终端粘贴等原功能）
• 按键 4 点按并拖移 → 滚动与导航（拖动窗口，配合 Swish 半屏/整屏停靠）

3D 与设计（适用：Blender、Sketch、Figma）

• 中键 点按并拖移 → 滚动与导航（Blender 里环绕模型）
• 按键 5 点按并拖移（向下）→ 滚动与导航（打开 App Exposé）
• 中键 点按 → 智能缩放（默认映射，Finder 与备忘录里等效双击放大）

配方只是起点，Buttons 标签页的动作列表里还有不少可替换选项。

常见问题：侧键失效、授权卡住、点击延迟

配置侧键后，浏览器前进/后退为什么失效了？

结论：该按键已被 Mac Mouse Fix 捕获，其他应用收不到它的原始事件。

1. 想恢复原样：在 Buttons 标签页删掉该按键的全部动作，按键立即释放。
2. 想两者兼得：保留捕获，给它分配"前进/后退"动作即可恢复前后翻页；"中键点击"动作可恢复打开链接等原功能。

开了开关没反应，或一直提示授权？

结论：多半是辅助功能权限没授到 Helper 上。

1. 确认系统设置 → 隐私与安全性 → 辅助功能里是Mac Mouse Fix Helper。
2. 若已在列表但仍提示：删除条目，按住 Shift 点菜单栏图标定位 Helper，拖回列表。
3. macOS 13/14 上开关无反应，可能是后台进程注册数据库问题，按仓库指南执行sudo sfltool resetbtm并重启。

单击有延迟？

结论：Mac Mouse Fix 在等你是否双击。删掉该按钮上所有与"Double Click"相关的动作，单击就会立即触发。

源码导览：值得看的五个目录

• Helper/Core/Buttons/：按键捕获与重映射，含按键输入接收（ButtonInputReceiver）与重映射分析（RemapsAnalyzer）。
• Helper/Core/Actions/：动作定义与执行，以及系统符号快捷键映射（SymbolicHotKeys）。
• Helper/Core/Scroll/：滚轮事件分析（ScrollAnalyzer）与滚动控制（ScrollControl），附开发笔记 ScrollNotes.md。
• Helper/Core/Smoothing/：平滑算法族，双指数平滑、指数平滑、滑动平均与环形缓冲。
• Shared/Config/：配置读写（Config.m）、响应式配置（ReactiveConfig.swift）与默认配置 default_config.plist。

结语

如果你的鼠标有三个以上按键，且受够了"侧键在 macOS 上毫无用处"，Mac Mouse Fix 是开源方案里完成度很高的选择：装好、授权辅助功能，再照场景配方给侧键分配动作，二十分钟内就能见效。想读懂它的实现，从 Helper/Core/ 下的 Buttons 与 Scroll 目录读起最合适。

核心关键词：Mac Mouse Fix、macOS 鼠标增强、鼠标侧键映射、平滑滚动 长尾关键词：macOS 鼠标侧键设置、Mac Mouse Fix 平滑滚动配置、Mac Mouse Fix 按键捕获恢复、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