Mac Mouse Fix 三种安装与配置方法:如何让 10 元鼠标滚出触控板手感
【免费下载链接】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 的开源鼠标驱动,它重新解释普通鼠标的滚动与按键信号,让鼠标获得类触控板的平滑滚动、可独立定制的侧键和双指手势。本文讲清官网下载、Homebrew、源码构建三种安装方式怎么选,以及装完后的关键操作,看完就能动手。
值不值得装
- 滚动带惯性:开启平滑滚动后,拨动滚轮像触控板双指滑动一样减速停下,不再按齿数一跳一跳。
- 侧键有活干了:原本闲置的左右侧键可以各自分配独立动作,比如切换桌面、播放/暂停媒体、截屏。
- 鼠标也能打手势:把"点击并拖移"设为"滚动与导航",按住按键拖动就等同双指滑动,在 Blender 里环绕模型、下拉呼出 App Exposé。
- 鼠标能按任意键盘键:包括 Apple 键盘特有的亮度、音量、媒体键,都能映射到鼠标按键上。
选型与安装
多数人直接官网下载安装即可。习惯终端或管理多台 Mac 的人用 Homebrew,装和更新都统一一条命令。只有想改代码或提前试用未发布功能,才需要源码构建。三者都要求 macOS 11 以上,配置文件位置一致,换安装方式没有迁移成本。
官网下载:多数人的默认选择
适合谁
普通用户,以及希望当天拿到最新功能和修复的人。
四步安装
- 打开浏览器,从官网下载最新的 .dmg 安装文件(需 macOS 11 Big Sur 及以上)。
- 打开 DMG,把 Mac Mouse Fix 图标拖入"应用程序"文件夹。
- 启动应用,打开 "Enable Mac Mouse Fix" 开关,并在"系统设置 → 隐私与安全性 → 辅助功能"中勾选本应用。
- 打开主窗口,确认菜单栏图标与滚动设置已生效,按需配置按钮动作。
若没生效
若从下载目录直接双击运行,没拖进应用程序文件夹 → 会触发 macOS 的"应用转置"机制,从随机只读位置启动,权限和更新都会出问题。启动后按钮和滚动增强完全不工作 → 先检查辅助功能权限是否已授予。
Homebrew 安装:终端一行命令
适合谁
开发者,以及需要在多台 Mac 上统一部署的用户。
安装步骤
- 确认已安装 Homebrew,没有就先装好。
- 执行安装命令:
brew install mac-mouse-fix- 安装完成后启动应用,授予辅助功能权限。
- 更新时运行
brew upgrade mac-mouse-fix,再重新打开应用。
注意
cask 索引有 1-3 天延迟,急需某个热修复时官网下载更快。它与官网版本不冲突、共用同一份配置,来回切换没问题。
源码构建:想改代码才需要
适合谁
熟悉 Xcode 工作流的开发者,或想加入自定义逻辑的人。
构建步骤
- 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix- 用 Xcode 打开
Mouse Fix.xcodeproj工程文件。 - 选择 "App" scheme,按 ⌘B 编译。
- 运行编译出的应用,授予辅助功能权限,流程与前两种方案相同。
改动前要知道
核心滚动与按钮逻辑在 Helper/ 目录,配置体系在 Shared/Config/。改这两处要同时考虑 App 和 Helper 两个进程,否则行为可能对不上。每次更新都要重新编译,维护成本是三者中最高的。
🖱️ 功能实操:装完之后做什么
装好并开启后,最先感受到的就是平滑滚动:拨动滚轮,光标带着惯性像触控板双指滑动一样前进,在 Scrolling 标签页可微调平滑度与速度。手感太"飘"就先把平滑度调低,速度不对就调到贴合你的手速。
侧键要先"捕获"再"分配"。打开按键标签页,把指针移到"+"区域,再按一下你想定制的鼠标按键,Mac Mouse Fix 会接管这个按键的信号并弹出确认提示(见下图)。注意:按键被捕获后,其他应用将无法再识别它,原有功能会失效——比如侧键在浏览器里前进后退不灵了,就是因为它已被捕获。详细说明可看仓库里的被捕获鼠标按键指南。
捕获完成后,每个按键可同时分配点按、双击、点按并拖移三类动作。一套常见配法:左侧键点按"切换桌面"、中键点按"智能缩放"、另一侧键点按"启动台",保存后立即生效。
"点击并拖移"值得单独配置:它模拟触控板的双指滑动。把它设为"滚动与导航"后,在 Blender 这类 3D 软件中按住按键拖动能环绕模型查看;向下拖可以打开 App Exposé——这是鼠标原本做不到的操作。
最后一个功能是让鼠标触发任意键盘按键,包括 Apple 键盘特有的亮度、音量、媒体播放键。配置时按住 Option 键即可选到这些特殊键,下图演示的是用鼠标直接调节音量。
🔧 排查与避坑
- 装完按钮没反应?先确认辅助功能权限已授予:在"系统设置 → 辅助功能"中打开开关并重启应用。仍无效就在终端运行
tccutil reset Accessibility com.noah-nuebling.Mouse-Fix清空权限记录,再重新授权。 - 部分侧键识别不到?依赖私有驱动软件的鼠标(如 Logitech Options 的型号)发送私有协议信号,Mac Mouse Fix 只能读取标准 USB 按键信号,换一只标准协议的鼠标最稳妥。
- 某个应用里滚动不对劲?在常规标签页开启"在菜单栏中显示",在该应用中工作时从菜单栏临时关闭平滑滚动。按应用区分的设置尚未上线,这是目前官方推荐的替代做法。
- 为什么开机总弹出应用窗口?多半是把它加进了"登录项"。常驻的 Helper 进程已在后台工作,移除登录项不影响功能。
- 点击为什么有停顿?Mac Mouse Fix 在等待判断你是否要双击。若某个按键不使用双击动作,直接删除对应条目,延迟就消失。
不必纠结选哪种安装方式,先装官网版、捕获第一个按钮(比如把"切换桌面"分给左侧键),手感立起来。之后所有滚动和按键设置都保存在~/Library/Application Support/Mac Mouse Fix/的配置文件中,换机前整体复制这个文件夹,新机器上原样恢复。遇到问题先查仓库里的中文文档。
【核心关键词】Mac Mouse Fix、Mac鼠标驱动、鼠标平滑滚动、鼠标按键重映射
【长尾关键词】Mac Mouse Fix安装教程、Mac Mouse Fix Homebrew安装、Mac鼠标侧键设置、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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考