企业官网建设流程全解析

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

滚动滚轮时页面一格一格地跳，中键在大多数 macOS 应用里没有任何反应，鼠标侧键更是形同虚设——普通鼠标在 Mac 上的体验大致如此。Mac Mouse Fix 是一款开源的 macOS 鼠标工具，只做两件事：把中键、侧键映射成你想要的动作，并让滚轮输出平滑滚动。本文给出从安装、授权到完成第一次侧键映射的最短路径，附上按角色整理的映射配方和三类常见故障的排查方法。

⚡ 快速上手：安装、授权到第一次侧键映射

把三步串起来，10 分钟内可以跑通闭环：

1. 在终端执行brew install mac-mouse-fix，安装最新版（要求 macOS 11 Big Sur 及以上）。
2. 启动 Mac Mouse Fix，按提示到「系统设置 → 隐私与安全性 → 辅助功能」中勾选允许。这是 macOS 的安全要求，没有这项权限，应用无法读取和改写鼠标事件，所有功能都不会生效。
3. 打开应用，切换到 Buttons 标签页：把鼠标指针移入中间的"+"区域，然后按下你想配置的鼠标按钮，在弹出的动作列表里选择功能（例如"Smart Zoom"或"Launchpad"）。保存后该按钮即完成映射，立即可以在任意应用中生效。

完成第 3 步时，界面右上角会弹出"Button X is now captured by Mac Mouse Fix / Other apps can't see the button anymore"的提示，这是按钮托管机制在起作用（下文细讲）。

两大核心系统：按钮托管与平滑滚动

按钮系统：把按钮"托管"出去

Mac Mouse Fix 的按钮系统采用"托管"模式：一旦你给某个按钮分配了动作，这个按钮就从系统层面交给应用接管，其他应用再也收不到它的原始事件。这样做的直接后果是：

• 行为一致——同一按钮在 Safari、Finder、IDE 中触发相同动作，不会因应用而异；
• 不会冲突——原始按钮功能被屏蔽，避免在某个应用里误触发系统默认行为。

如果你希望某个按钮恢复原始功能，给它分配"Middle Click"这类透传动作，或者直接删掉该按钮的所有绑定即可，托管随之解除。完整说明见仓库内的 CapturedButtonsMMF3.md。

滚动系统：三个参数

打开 Scrolling 标签页，核心就三个参数：

除此之外还有三个辅助开关：水平滚动（配合修饰键实现横向滚动）、精准模式（Precise，配合修饰键逐行移动）、方向反转（自然滚动）。它们各自绑定一组修饰键，可在字段里直接按键录制。

侧键映射配方表：按角色抄作业

每个按钮除了"Click"，还能单独设置"Double Click"和"Click and Drag"，同一按钮可承载多个动作；按钮前缀组合（例如按住按钮 5 再点中键）同样可以绑定独立动作。

🔧 排错手册：三类常见问题

按钮"失效"了大概率不是故障，而是该按钮已被托管，应用收不到原始事件。两种处理方式：为它分配一个透传动作（如 Middle Click）模拟原功能；或删掉绑定、解除托管。如果只想在个别应用恢复原行为，在对应应用的设置中为该按钮单独配置即可。

滚动感觉不对按顺序排查：先在 Scrolling 标签页把平滑度降到 Medium 试手感；仍不自然就关闭触控板模拟；确认方向开关（自然滚动）与你的预期一致；最后检查 General 标签页的滚动总开关是否被误关（应用内出现"恢复滚动"提示时说明它正处于关闭状态）。

多台设备配置不一致所有设置集中在一个 plist 文件里：~/Library/Application Support/com.nuebling.mac-mouse-fix/config.plist。把它备份后拷贝到新设备相同位置即可还原；MMF 3 也支持通过 iCloud 自动同步。文件格式与版本迁移规则见 ConfigReadme.md。

进阶：按应用配置、手势组合与性能建议

• 按应用独立配置：为浏览器单独设置侧键为前进/后退，为设计软件设置画布操作；游戏场景可降低动作响应，避免误触发。
• 手势组合：使用"Click Button 5 + Click Middle Button"这类按钮前缀组合，或为水平滚动、精准模式绑定不同修饰键，一个物理按钮可以扩展出多组动作。
• 键盘按键也能上鼠标：动作列表支持任意键盘按键，包括 Apple 键盘的亮度、音量、媒体专用键（无 Apple 键盘时按住 Option 选择），适合外接显示器用户。
• 性能：只托管实际使用的按钮；不需要触控板模拟时保持关闭，减少事件处理开销。

原理速览：一条事件处理链路

整条链路不复杂，四步走完：

1. Helper 进程通过事件接收器捕获原始鼠标事件，入口在 Helper/Core/Buttons/ButtonInputReceiver.h；
2. 事件进入手势分析，区分单击、双击、点击并拖动等模式，逻辑在 Helper/Core/Buttons/Buttons.swift；
3. 识别结果交给动作执行器，按下配置发出对应系统事件，见 Helper/Core/Actions/Actions.m；
4. 全部行为由config.plist驱动，Helper 监听该文件变化，修改配置无需重启应用。

下一步

建议先用"平滑度 Medium + 两个侧键映射"跑一周，手感稳定后再按上面的配方表补全配置。每次启动时留意 About 标签页的版本提示——这个项目迭代较快，新版本通常直接修复滚动兼容性问题，保持更新比反复调参更划算。想深入本地化文档，可以看 中文 Readme 与 支持文档目录。

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