Mac Mouse Fix 完整指南：如何把普通鼠标升级成 macOS 触控板级输入设备

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-fixMac Mouse Fix 是 macOS 上的鼠标增强工具拦截普通鼠标的滚轮与按键事件重新注入平滑滚动、触控板手势模拟和任意按键重映射。目标是让你花几十块钱买的第三方鼠标用起来比 Apple 触控板和高端旗舰鼠标更顺手。安装 Mac Mouse Fix 前先确认你的系统版本两条路都能拿到应用打开官方下载页取最新版本安装包在终端执行 Homebrew 命令一行装完brew install mac-mouse-fix需要旧版本比如老系统可以去项目的 Releases 页面按版本号下载。装之前先对照下表确认你的系统能跑哪一代装错代数的代价是界面错乱甚至功能失效系统版本对应产品macOS 11 Big Sur 及以上Mac Mouse Fix 3.x当前主线Apple Silicon 原生macOS 10.13–10.15High Sierra / Mojave / CatalinaMac Mouse Fix 2 最新版3.0.0 及以后可能有显示问题部分功能异常macOS 10.11–10.12El Capitan / SierraMac Mouse Fix 2.2.0 及以下平滑滚动档位怎么选从一格格卡顿到惯性滑行滚轮一格一格咔咔响是普通鼠标最显旧的地方。在 Scrolling 标签页打开 Smooth Scrolling滚轮立刻变成惯性滑行手感接近用手指推内容。四档平滑度对应四套不同的惯性动画曲线区别在于松手后内容滑行多久才停档位行为off关闭平滑滚轮直接透传无惯性low极短惯性最跟手刻意牺牲流畅感换取控制力此档还会关闭快速滚动加速regular日常推荐响应快、滑行短扫描长文档不拖沓high默认高惯性最接近 Apple 触控板的滑行质感几个随用随查的配置项Scroll.speed默认medium滚轮灵敏度可选system/low/medium/high。选system时完全交回 macOS 原生算法不应用自己的加速曲线。Scroll.reverseDirection默认true反向滚动开关。Scroll.trackpadSimulation默认true触控板模拟。开启后high档会额外发送与真触控板完全同构的滚动事件让 Xcode、Dock 这类对触控板事件敏感的程序把你当触控板对待关闭后只保留高惯性曲线本身。Scroll.precise默认false精准滚动适合逐行微调。Scroll.modifiers下的horizontal/zoom/swift/precise给水平滚动、缩放、快速滚动、精准滚动各绑一个键盘修饰键按住即可临时切换滚动模式。速度档位背后是一条输入速度 → 滚动距离的加速曲线手转得越快每格滚轮带出的像素越多。拿high平滑档举例代码里 minSens 取[60, 90, 150]、maxSens 取[120, 180, 240]单位像素/格再按 low/medium/high 速度档位线性插值。连续快速甩轮还会触发快速滚动fast scroll加速——regular/high档约 2~3 次快速甩轮后起效、指数加速最高 7.5 倍off档则放宽到 6 次、上限 3 倍low档干脆关掉保证手感线性可控。曲线与参数的完整定义在 ScrollConfig.swift每档的贝塞尔控制点、拖拽系数dragExponent / dragCoefficient / stopSpeed控制减速阶段的物理感都写在animationCurveParamsMap里。一个按钮模拟三指、四指触控板手势想切换桌面、打开 Launchpad、捏合缩放这些在触控板上靠手指在 Mac Mouse Fix 里靠鼠标侧键。首次启动时应用会按你的鼠标按键数自动套用一套预设模板三键或五键存在配置的Constants.defaultRemaps里。三键鼠标以中键为例的默认模板单击中键 → 系统级快捷键快捷键变体 70长按中键 → 系统级快捷键变体 36双击中键 → 系统级快捷键变体 160按住中键并拖拽 → 模拟三指滑动配合dragTrigger触发。五键鼠标在此基础上多出两条侧键通道一条侧键单击可触发 Launchpad、滚动时叠加四指捏合、拖拽触发三指滑动另一条侧键单击触发 Smart Zoom、滚动时叠加缩放、拖拽触发两指滑动。变体 70 / 36 / 160 对应的正是 Launchpad、Mission Control、Dock 这类系统级动作。模板只是起点每个重映射项都由三段拼成看懂这三段就能改任何按钮trigger触发button按键号durationclick单击 /hold长按level单击层数也支持dragTrigger按住拖拽、scrollTrigger滚动时这类特殊触发effect动作symbolicHotkey系统快捷键variant填编号、smartZoom、modifiedDragTypethreeFingerSwipe/twoFingerSwipe等拖拽手势、modifiedScrollEffectModificationfourFingerPinch/zoom等滚动叠加效果modifiers附加条件如buttonModifiers——必须同时按住另一按钮才生效。以按住中键拖拽 → 三指滑动为例trigger 是dragTriggereffect 是modifiedDragType: threeFingerSwipemodifiers 要求button 3处于按下状态。动作的最终执行入口是 Actions.h 里的executeActionArray:phase:同一套动作按按下 / 抬起 / 组合三个阶段分别驱动所以单击、长按、拖拽能各走各的。一个小坑重映射会给单击引入一点延迟因为应用要等doubleClickThresholdGeneralConfig.swift 中硬编码为 0.01 秒确认你不会双击。介意的话删掉该按钮上所有双击类动作即可。双进程架构与 plist 配置为什么关掉应用也生效Mac Mouse Fix 是双进程设计这是理解一切行为的钥匙主应用App只做设置界面App/ 下全部是 UI、更新和授权相关代码Helper 进程常驻后台真正拦截并改写滚轮、按键、指针事件核心模块集中在 Helper/Core/——Scroll/处理滚动、Buttons/处理按键捕获、Actions/执行动作、Coordinate/输出合成事件、PointerSpeed/管指针速度、Config/存放各配置类的解析逻辑。你在界面上打开 Enable Mac Mouse Fix 后Helper 进程由 launchd 拉起并常驻。这意味着关掉应用窗口、甚至重启电脑增强效果都还在——所以它不需要加进登录项。所有设置以 key-path 字典形式存在 plist 里模板见 default_config.plist顶层键为Scroll/Pointer/General/Remaps/License/State/Constants。配置由 Config 单例统一读写改完界面选项后 Helper 会立即重载对应配置类如ScrollConfig.reload()并切换曲线无需重启。指针Pointer配置值得单独说一句Pointer.sensitivity默认 1、Pointer.acceleration默认 0.6875对应系统com.apple.mouse.scaling档位、Pointer.useSystemAcceleration默认false。PointerConfig.swift 会把参数化加速度曲线直接写进 Apple 的 HID 指向驱动并做两种补偿——轮询率补偿以 125 Hz 为基准轮询率指鼠标每秒向系统报告位置的次数和 CPI 补偿以 1000 CPI 为基准CPI 即鼠标每移动一英寸报告多少个像素点——让不同硬件的鼠标在相同设置下手感一致。这部分功能仍在迭代中。General键里还有几个实用开关showMenuBarItem默认false开启后菜单栏出现图标、scrollKillSwitch/buttonKillSwitch滚动/按键一键总开关默认false、checkForUpdates默认true、lockPointerDuringDrag拖拽手势期间锁定指针默认false。进阶玩法窗口管理、键盘功能上鼠标、App Exposé用鼠标拖窗口替代触控板双指滑窗前提安装 Swish 这类窗口吸附工具此技巧依赖 Swish 的双指滑窗能力。把某个按钮的 Click and Drag 动作设成 Scroll Navigate之后按住该按钮拖窗口就能把窗口甩到半屏、四分之一屏或全屏。原则是触控板双指滑动能做的事Scroll Navigate 基本都能等价完成。️把亮度、音量、媒体播放绑到鼠标上重映射时可以直接选键盘上的任意键包括只出现在 Apple 键盘上的亮度、音量、媒体功能键。手边没有 Apple 键盘也没关系在按键选择器里按住 Option⌥这些特殊键就会显示出来供你挑选。️按住按钮向下拖打开 App Exposé把某按钮的 Click and Drag 动作配成 Spaces Mission Control然后按住它向下拖即可展开当前应用的所有窗口。没反应的话多半是系统层面禁用了 App Exposé 触控板手势——去系统设置里打开它或在终端执行defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock授权、费用与卸载一次说清Mac Mouse Fix 2 及更早版本永久免费且继续维护Mac Mouse Fix 3 提供 30 天免费试用之后一次性付费买断后不限期使用。一份授权覆盖你自己名下的所有 Mac同一 Apple 账户登录时还会经 iCloud 自动同步过去——注意授权不能公开发布分享给家人可以。它覆盖全部 3.x 版本未来的 4.0 这类大版本可能要求重新购买。退款没有正式政策但 30 天试用本身就是缓冲购买后遇到问题直接联系开发者即可。通过 PayPal 捐赠过的用户可申请免费授权。商业化没有改变开源属性MMF 3 及以后继续遵循项目自己的 MMF License见 License鼓励你把源码用进自己的项目只是别原样再发一份副本。卸载很简单把应用拖进废纸篓即可。但 macOS 不允许应用在自己被删时顺手清理残留所以配置文件前文提到的 plist含全部配置与授权状态会留在系统里建议配合 AppCleaner 之类的工具彻底清掉。常见疑问速查系统门槛、功能行为、授权使用门槛类Apple Silicon 原生吗是100% 原生运行。我的鼠标支持吗走标准协议的鼠标绝大多数没问题最稳的办法就是装来试。例外是依赖厂商专有驱动协议如 Logitech Options 那类的鼠标部分按键目前无法识别。Magic Mouse / 倾斜滚轮Magic Mouse 目前不受任何影响后续可能加增强可倾斜滚轮的水平滚动会被处理得更自然但暂时不能用倾斜触发切桌面等动作。功能行为类点击为什么有延迟双击判定等待0.01 秒造成的删掉该按钮上的双击动作即消失。有按应用区分的设置Profiles吗MMF 2 有MMF 3 还在规划应用级与鼠标级都在。过渡方案在General页打开Show in Menu Bar用菜单栏按钮临时禁用平滑滚动或按键重映射。如何关掉指针加速度应用内暂无开关macOS 14 Sonoma 及以上可在 系统设置 → 鼠标 → 高级… 中关闭。更好的方案已在路上。授权相关类一台授权用几台机器你自己的所有 Mac 同账户 iCloud 同步。覆盖哪些版本全部 3.x4.0 可能需重新购买。会收集我的数据吗应用无广告、不收集个人信息。唯一例外是购买环节销售平台会保存你的邮箱等信息用于发授权码与退款这对开发者可见且无法关闭。谁该用 Mac Mouse Fix下一步往哪深挖有普通鼠标但想要触控板级滚动、侧键多到无处安放、或者想把窗口管理和媒体控制都收进一只手里的用户基本就是为目标人群。反向名单同样清楚只依赖厂商专有协议的鼠标或只用 Magic Mouse 的暂时绕开它。想往下挖的话按这条线索走效率最高ScrollConfig.swift 里每档曲线的贝塞尔参数与加速表看手感是怎么被数值定义的PointerConfig.swift 顶部的注释讲清了轮询率与 CPI 补偿的推导过程Actions.m 的动作分发则是重映射从配置到执行的落点。想参与项目提反馈、补翻译、发 PR 都行——方向拿不准时先提一个只描述改动方案、几乎不含代码的 PR 让作者确认能省掉大量返工。【免费下载链接】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），仅供参考