☰
Mac Mouse Fix 安装完全指南:如何一次选对安装方式?
2026/10/2 8:12:30 网站建设 项目流程

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 鼠标工具,让普通鼠标拥有接近触控板的滚动与手势体验。Mac Mouse Fix 安装有三条路径:官网下载、Homebrew、Mac App Store,本文带你 1 分钟选对方式,避开首次启动的权限坑。

如何安装 Mac Mouse Fix:4 类用户先对号入座

追新版 → 官网下载。官网同时提供稳定版和 Beta 版,没有 App Store 7-14 天的审核等待。

省事型 → Mac App Store。安装、权限、更新全部由系统托管,不需要手动操作。

求稳型 → Mac App Store。苹果公证的沙盒构建,出现“未识别开发者”提示的概率最低。

开发者 → Homebrew。一条命令完成安装与升级,可以写进新机器初始化脚本。

拿不准就选官网下载:功能完整、版本最新,本文后续的排查内容对三种方式都适用。

官网下载安装 Mac Mouse Fix

适合想要完整功能与最快更新的追新版用户。

  1. 到项目官网或 Releases 页面下载最新 dmg,最新版支持 macOS 11 及以上。
  2. 打开 dmg,把应用拖入“应用程序”文件夹。
  3. 启动应用,按弹窗提示授予辅助功能权限。

验证:启动后菜单栏出现 Mac Mouse Fix 图标,且“Enable Mac Mouse Fix”开关为开启状态,即安装成功。另请注意:3 版免费试用 30 天,之后一次性小额付费继续使用;2 版及以下永久免费。

Homebrew 一行命令装好

适合希望批量管理多台 Mac、用脚本完成安装升级的开发者。

  1. 确认已安装 Homebrew。
  2. 在终端执行:
brew install mac-mouse-fix
  1. 完成后从“应用程序”启动 Mac Mouse Fix。

验证:终端执行brew list --cask mac-mouse-fix能看到版本号即可。以后升级同样一行命令brew upgrade mac-mouse-fix。

Mac App Store 一键安装

适合不碰终端、希望一切由系统托管的新手。

  1. 打开 Mac App Store,搜索 “Mac Mouse Fix”。
  2. 点击“安装”,下载完成后从启动台启动。

验证:启动后主界面正常打开并弹出辅助功能授权请求,说明安装无误。两点须知:沙盒版本功能略有裁剪,更新需经苹果 7-14 天审核;配置文件目录与另外两种方式不同,见下一节。

首次启动权限授予:两个新手最容易卡住的坑

坑一:辅助功能权限要同时给应用和 Helper。

  • 现象:应用启动了,但鼠标按钮没反应;或者只授权了一次,功能仍不生效。
  • 原因:拦截全系统鼠标事件需要 macOS 向应用和后台进程 “Mac Mouse Fix Helper” 分别授予辅助功能权限,缺一个都不行。
  • 解决:在“系统设置 → 隐私与安全性 → 辅助功能”中同时打开 “Mac Mouse Fix” 和 “Mac Mouse Fix Helper” 两项。卡住时先执行下面命令重置权限状态,再到应用里重新申请:
tccutil reset Accessibility com.noah-nuebling.Mouse-Fix

坑二:配置文件目录因安装方式而异。

  • 现象:打开 ~/Library/Application Support/Mac Mouse Fix/ 发现目录不存在,或换安装方式后设置“丢了”。
  • 原因:App Store 沙盒版的数据存放在独立的 Containers 目录,与官网、Homebrew 用的常规路径互不可见。
  • 解决:官网/Homebrew 的配置在~/Library/Application Support/Mac Mouse Fix/;App Store 版在~/Library/Containers/com.noah-nuebling.Mouse-Fix/Data/Library/Application Support/Mac Mouse Fix/。换安装方式时,先把配置 plist 从旧目录复制到新目录。各项配置的默认值可在仓库 Shared/Config/ 中对照查看。

装好后先配置这 3 个功能

按钮自定义,是安装后最值得先做的设置。进入 Buttons 标签页,把指针移入“+”区域,点击鼠标任意一个按钮即可捕获并加入下方列表。接着为单击、双击、点击并拖动分别指定动作:“Scroll & Navigate” 模拟触控板双指滑移,可在 3D 软件里旋转视角;“任意按键”甚至能触发亮度、音量这类苹果专属按键。Mac 鼠标侧键设置一般从这里开始。

平滑滚动,把棘轮滚轮变成惯性滚动。在 Scrolling 标签页打开 Smooth Scroll,普通鼠标滚轮即获得接近触控板的顺滑惯性,属于最常用的 Mac 鼠标滚动优化手段。主要调两项:滚动方向(自然滚动)与灵敏度、加速度曲线,改动即时生效,无需重启。个别应用出现冲突时,在 General 标签页打开“Show in Menu Bar”,即可从菜单栏临时关闭平滑滚动,不必打开主界面。

指针速度,让指针移动幅度匹配你的手型。在 Pointer 设置区调整灵敏度与加速度曲线:曲线决定“鼠标移动多少”对应“指针走多快”,提供多种预设,各曲线的实现代码在仓库 Shared/Math/Curves/ 目录。如果指针发飘,macOS 14 及以上还可以到“系统设置 → 鼠标”里关闭系统级“指针加速”。

故障排查表

现象可能原因解决办法
装完按钮没反应辅助功能权限未给全,Helper 未勾选在辅助功能列表中同时勾选应用与 Helper
按钮突然失效其他驱动软件(如 Logitech Options)抢占卸载或停用其他鼠标驱动,只保留一个
点击有明显延迟该按钮配置了 Double Click 动作在 Buttons 标签页删掉该按钮的双击动作
部分按钮无法识别鼠标走私有协议而非标准 USB换标准协议鼠标,兼容性最稳
换安装方式后设置丢失官网/Homebrew 与 App Store 目录不同在两个目录之间手动复制配置文件

3 条选择口诀

  1. 要最新功能选官网,要零折腾选 App Store,要一条命令选 Homebrew。
  2. 无论哪种安装方式,先把应用和 Helper 两项辅助功能权限打开,再谈功能。
  3. 配置目录分两半:官网和 Homebrew 在 Application Support,App Store 在 Containers,排查问题别找错地方。

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询