5 分钟配好 Mac 鼠标侧键映射与平滑滚动: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 是一款开源的 Mac 鼠标增强工具,主打鼠标侧键映射与平滑滚动,让普通鼠标不碰键盘也能完成 macOS 上的高频操作。解决 Mac 鼠标侧键与滚轮的三类常见问题macOS 的输入事件体系主要面向触控板设计,第三方鼠标的按钮和滚轮信号以较原始的状态进入系统,日常使用中反复出现的体验问题可以整理成一张对照表:遇到的问题系统默认表现接入 Mac Mouse Fix 后侧键(Button 4/5)基本不可用无对应系统功能,常被应用自身占用可映射到 50 多种系统功能:启动台、智能缩放、任意键盘快捷键滚轮滚动生硬、缺少惯性逐格跳跃式滚动平滑滚动,并支持触控板模拟,滚动时有自然的加减速高频操作要换手到键盘依赖组合键,操作被打断侧键直接触发,支持单击、双击、按住、点按并拖动等动作安装 Mac Mouse Fix 并完成第一次侧键映射三条安装路径:预编译、Homebrew 与源码预编译版本(推荐普通用户):从项目发布页(Releases)下载最新安装包,解压后将应用拖入应用程序文件夹。Homebrew:在终端执行brew install mac-mouse-fix源码编译(适合开发者):执行git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix,用 Xcode 打开Mouse Fix.xcodeproj,选择 App 目标编译运行。要求 macOS 11 Big Sur 及以上。如何一次性授予辅助功能与输入监控权限首次启动时,应用会请求辅助功能权限。在系统设置 → 隐私与安全性 → 辅助功能中打开 Mac Mouse Fix 的开关。在同一个隐私列表中找到输入监控,为 Mac Mouse Fix 及其 Helper 进程分别打开开关。开关改动后重启应用使其生效。注意:如果直接从下载文件夹双击运行,macOS 会以 App Translocation 机制在临时路径运行它,此前授予的权限会失效。把应用移入应用程序再启动即可。验证第一个侧键映射是否生效打开按键标签页,把鼠标指针移进界面中央的 区域。点击你想配置的鼠标侧键,例如 Button 5。窗口弹出按键 5 被 Mac Mouse Fix 捕获到的提示,表示捕获成功,其他应用将不再收到该按键的信号。在新出现的配置行中选择一个动作(例如启动台),然后点按侧键,确认动作被触发。按使用目标选择侧键映射方案比起逐个记功能名称,更实用的做法是按我想完成什么来配置。下面三组方案覆盖最常见的目标,动作即应用中每个按钮可单独指定的触发方式:单击、双击、按住、点按并拖动、点按并滚动。代码导航:侧键切换标签页与窗口按键动作效果Button 4单击切换到下一个标签页(映射到编辑器的快捷键)Button 4双击关闭当前标签页Button 5点按并拖动Scroll Navigate:等同触控板双指滑动,可分屏窗口、切换应用中键单击智能缩放创意工具:移动画布与缩放视图按键动作效果Button 4单击缩小画布Button 4点按并滚动调整画笔大小(映射为快捷键)Button 5点按并拖动Scroll Navigate 移动画布,3D 软件中可环绕视角中键单击智能缩放;双击可切换抓手工具文档办公:翻页与自动滚动按键动作效果Button 4单击上一页Button 4点按并滚动调整文档缩放Button 5单击下一页中键长按进入自动滚动侧键进阶玩法:组合动作与触控板手势模拟组合动作:一个按钮可以同时挂多个动作,按键在不同操作方式下执行不同功能。例如把 Button 5 的点按并拖动设为 Scroll Navigate 后,按住它移动鼠标,窗口可以被贴到屏幕半边或四分之一位置——这类按住 拖拽/滚动的组合,就是应用所说的组合动作。触控板手势模拟:Scroll Navigate 会模拟双指滑动,滚动、应用内页面导航等原本只有触控板能完成的双指手势,都可以改由鼠标发出。按应用临时关闭:应用级配置文件在 3.x 中仍在计划中,过渡做法是在通用标签页打开显示在菜单栏,之后可以从菜单栏项目临时关闭平滑滚动或按键功能,以应对个别不兼容的应用。指针与轮询率调优:Pointer 标签页可单独调整灵敏度与加速度。高轮询率游戏鼠标(如 1000Hz)建议先测出实际轮询率,再决定是否需要降低灵敏度。原理速览:IOKit 直连与双指数平滑滚动应用采用简单的双进程分工:主窗口只负责配置,实际工作由后台 Helper 进程完成。Helper 在系统层面监听鼠标事件,绕过品牌驱动层,直接通过 IOKit 与底层输入接口与系统交互。在 Apple Silicon 机型上,其 CPU 占用约 0.8%~1.2%,内存占用不到 15MB,点击响应延迟约 6-8ms。平滑滚动的核心是双指数平滑算法(Double Exponential Smoothing):它维护水平与趋势两个状态量,并随每一帧滚轮输入动态更新。开始滚动时速度逐渐爬升,停止转动后自然减速,这就是可感知的惯性。算法实现分布在 Helper/Core/Smoothing/ 与 Helper/Core/Scroll/ 两个目录。所有设置最终写入 plist 文件,Shared/Config/default_config.plist 中的Scroll节点大致如下:keyScroll/key dict keysmooth/keystringhigh/string keyspeed/keystringmedium/string /dictMac 鼠标设置常见问题:权限、备份与兼容性Q:授权后侧键仍无反应?Mac 鼠标设置不生效多与权限有关,按顺序排查:辅助功能与输入监控两处的开关是否都打开;应用是否放在应用程序文件夹中(从下载运行会触发 App Translocation,导致已授权实例失效);改动开关后是否重启了应用。Q:配置存放在哪里,如何备份?用户配置保存在~/Library/Application Support/MacMouseFix/,许可相关数据位于同目录的 SecureStorage 子文件夹,定期复制该文件夹即可完成备份。界面右下角的恢复默认值…可以回到出厂配置。Q:我的鼠标会被识别吗?多数 USB 与蓝牙鼠标均可使用。个别依赖专用驱动(如 Logitech Options 生态)的鼠标,目前无法被完全识别所有按键;Apple Magic Mouse 暂不受该应用影响。Q:点击侧键为什么有一点点延迟?为该按钮配置了双击动作时,系统需要短暂等待以判断是否为双击。若不需要双击,删除该动作即可让单击立即响应。参与项目与相关资源一套配好的侧键映射加上平滑滚动,足以应付大多数日常操作;遇到故障或希望提出新功能,可以在仓库的 Issue 中反馈,也可以修改Localization/目录下的翻译文件参与本地化。默认配置文件:Shared/Config/default_config.plist按键映射核心代码:Helper/Core/Buttons/滚动模块代码:Helper/Core/Scroll/按键捕获指南:Support/Guides/CapturedButtonsMMF3.md简体中文文档:Markdown/LocalizedDocuments/zh-Hans/Readme.md【免费下载链接】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），仅供参考