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鼠标侧键在 macOS 里要么失灵要么只够浏览器前进后退滚轮一格一格硬跳松手还刹不住。Mac Mouse Fix 是一款免费开源的 macOS 鼠标增强工具专门解决侧键映射和 Mac 滚轮平滑滚动这两个系统给不了的问题全程不用改代码。安装前查两件事鼠标兼容性与系统版本先花 30 秒确认你能用装完再排查很折腾。鼠标协议走标准 USB 或蓝牙协议的鼠标基本都能用罗技、雷蛇、微软等品牌的常规型号没问题。例外一依赖厂商专有驱动协议通信的鼠标部分按键可能识别不到例外二Apple Magic Mouse 目前不受它增强。系统版本最新版要求 macOS 11 Big Sur 及以上。10.13 到 10.15 的老系统可以退回 Mac Mouse Fix 2 使用。安装并授予两项权限三种安装方式按你的习惯选一种方式操作适合预编译 DMG从官网下载最新版拖入应用程序文件夹大多数用户Homebrew终端执行brew install mac-mouse-fix想跟随 Homebrew 统一升级源码编译克隆仓库后用 Xcode 打开工程编译运行 App 与 Helper 两个 target开发者git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix cd mac-mouse-fix首次启动会请求两项权限作用不同都要给辅助功能让它能注入键盘动作侧键映射到系统功能靠它。输入监控让它能听到鼠标事件平滑滚动靠它。弹窗没出现时手动前往 系统设置 → 隐私与安全性分别在辅助功能和输入监控列表里打开 Mac Mouse Fix 的开关。改完开关必须完全退出并重启应用——它的 Helper 进程只在启动时读取一次权限状态不重启配置不会生效。一分钟捕获你的第一个侧键打开 App进入Buttons标签页。把鼠标指针移到面板中央的捕获区域然后按下你想配置的侧键。界面提示已捕获 Button 4或对应编号即成功——这个按键从此由 Mac Mouse Fix 独占其他应用收不到它的信号。给这个按键分派一个动作比如呼出 Mission Control。再按一次侧键触发成功。三个最常见的痛点分别怎么解滚动一顿一顿开启平滑滚动症状滚一格跳一格快速滚动冲过头松手没有惯性减速。效果快速滚动时像飞掠慢下来自然停稳接近触控板手感按住你选定的修饰键可切入精细模式逐行阅读长文档时粒度更细。配置Scrolling 标签页打开平滑滚动开关同一标签页里选精细模式用的修饰键。侧键闲置浪费映射到系统动作症状鼠标有 4、5 号侧键甚至中间键macOS 却只当它们不存在。效果每个被捕获的按钮都能分派到几十种系统级动作几个实用组合Button 4 单击呼出 LaunchpadButton 5 单击打开 Mission Control中间键单击控制媒体播放/暂停Button 5 单击滚动连续调节屏幕亮度。配置Buttons 标签页为按键添加条目选触发方式再选动作面板里按住 Option 可展开亮度、音量、播放这类 Apple 键盘特有的特殊键。不同应用想不同设置按应用切换症状PDF 里核对数据需要原始滚轮粒度浏览器里又想要平滑滚动没法两全。版本差异Mac Mouse Fix 2 在 More 菜单的 App-specific settings 里可按应用禁用平滑滚动等功能Mac Mouse Fix 3 尚未提供该功能已在计划中替代方案是在 General 标签页打开 Show in Menu Bar之后从菜单栏开关手动开关平滑滚动等功能。典型流程在 PDF 阅读器里关掉平滑滚动逐行核对切回浏览器再打开之后每次靠菜单栏开关切换。按你的工作场景抄一组预设设计适用 Photoshop、Figma、Sketch、IllustratorButton 4 单击 → 缩小画布视图Button 4 点击拖动 → Scroll Navigate模拟双指滑动平移画布中间键单击 → 智能缩放中间键双击 → 切换抓手工具编程适用 VS Code、Xcode、TerminalButton 4 单击 → 上一个标签页Button 5 单击 → 下一个标签页Button 5 双击 → 关闭当前标签页中间键单击 → 呼出 Mission Control 或命令面板阅读研究适用 PDF 阅读器、浏览器、笔记应用Button 4 单击 → 上一页Button 5 单击 → 下一页Button 4 单击滚动 → 调整页面缩放中间键双击 → 新标签页打开链接进阶四种组合模式与手感参数同一个按键能挂四种操作模式操作模式示例适合场景单击Button 5 → Mission Control一步触发的系统功能点击拖动Button 4 → Scroll Navigate模拟双指滑动平移画布、环绕 3D 物体、分屏吸附窗口点击滚动按住 Button 4 再滚轮 → 亮度连续调节数值型参数多键组合按住某键再点另一键给特定软件留一个专用手势手感参数四个各管一件事平滑度档位Scrolling 标签页提供低/中/高等级以文字为主的文档选低档图片视频多就调高。轮询率界面显示鼠标实际向系统上报位置的真实频率游戏鼠标常见 1000Hz数值明显偏低说明蓝牙链路不稳先修连接再调参数。指针加速应用内不提供开关macOS 14 及以上去 系统设置 → 鼠标 → 高级 里关闭。单击延迟某个按键配了双击动作单击时系统会等你确认是不是双击产生等待感删掉该按键的双击条目即可消除。一句话原理前台应用只是配置面板真正干活的是常驻后台的 Helper 进程它通过 macOS 的 IOKit/HID 事件层和全局事件监听拿到鼠标输入先做平滑、重映射再把处理后的事件重新注入系统因此对所有应用生效而不仅限于某个窗口。平滑滚动的核心是一条递推新水平 L α × 当前输入 (1 - α) × (上一水平 Lprev 上一趋势 Tprev) 趋势 T β × (L - Lprev) (1 - β) × Tprev趋势项 T 让滚动带上加速度和减速惯性实现见 平滑算法模块 与 滚动主流程。所有设置集中在一个 plist~/Library/Application Support/com.nuebling.mac-mouse-fix/config.plist。备份就是拷走这一个文件换机后放回原路径全部按键映射和滚动参数原样恢复出厂默认值见 默认配置文件。出问题时的排查顺序症状排查顺序配置不生效辅助功能、输入监控两个权限开关是否都开 → 应用是否重启过 → 菜单栏开关是否被手动关掉 → 按键是否已捕获某按键没反应Buttons 标签页左侧是否出现该按键编号没出现就重新走一遍捕获流程滚轮被吞掉确认滚轮是否被平滑滚动捕获在 Scrolling 标签页里删掉对应捕获条目即恢复原始行为单击有等待感该按键是否配了双击动作删掉双击条目轮询率异常偏低换 USB 口或重连蓝牙排除链路问题后再看软件想整体停用General 标签页有总开关关掉后 Helper 停止生效无需卸载结语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），仅供参考