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 默认只会拿它们做前进/后退。按键重映射可以把任意动作绑到任意键:单击开 Launchpad、长按切换桌面、双击切换应用都行。
- 手势做不了。切换桌面、显示桌面、打开 Launchpad 在触控板上靠双指,而鼠标设一个「Click and Drag → Scroll & Navigate」就能模拟双指滑动。
快速上手:安装命令与首次开启
终端执行安装命令即可:
brew install mac-mouse-fix也可以从官方网站下载安装包,历史版本可在 Releases 页找到。首次使用注意两点:
- 在系统设置中授予**辅助功能(Accessibility)**权限,应用需要监听鼠标事件;
- 打开「Enable Mac Mouse Fix」开关。这个开关控制的是一个常驻后台的 Helper 进程,此后即使关掉主窗口、重启电脑,鼠标增强依然生效——不必把它加进登录项。
功能与默认配置一览
| 功能块 | 它做什么 | 出厂默认 |
|---|---|---|
| 平滑滚动 | 惯性滚动动画 + 触控板手势模拟 | 平滑度 high、速度 medium、反转方向开、触控板模拟开 |
| 按键重映射 | 任意按钮 × 点击/双击/长按/拖拽/滚轮五种触发,映射到任意动作 | 首次启动注入三键或五键预设模板 |
| 指针控制 | 调整指针速度与加速度曲线 | 灵敏度 1、加速度 0.6875 |
| 修饰键组合 | 滚轮时按住修饰键,切换水平滚动/缩放/快速/精准模式 | 每项各有一个修饰键事件标志 |
重映射的动作集里包含系统级快捷键(symbolicHotkey)、Smart Zoom、三指/两指滑动模拟、缩放等,覆盖大部分触控板手势。
进阶原理:配置键与源码模块对照
所有设置以 key-path 结构存在 plist 里,Shared/Config/default_config.plist 就是默认模板。每个配置项背后都有明确的读取模块:
| 配置键 | 读取它的模块 | 工作机制 |
|---|---|---|
Scroll.smooth | ScrollConfig.swift | 映射为四档动画曲线:关闭 / 极低惯性 / 低惯性 / 高惯性,每档是一组贝塞尔参数;最高档可再叠加触控板模拟 |
Scroll.speed | 同上 | 决定加速度曲线的灵敏度区间;选 system 时完全交给 macOS 原生算法 |
Scroll.modifiers.* | 同上 | 存修饰键事件标志位,按住对应键滚动时进入水平/缩放/快速/精准模式,并临时换一套曲线 |
Pointer.* | PointerConfig.swift | 向 Apple HID 驱动写入加速度曲线,内部做轮询率补偿(基准 125 Hz)与 CPI 补偿(基准 1000),让不同硬件手感一致 |
Remaps | Actions.h | 每条记录由触发条件 + 效果 + 修饰条件组成,按下/抬起/组合三个阶段分别派发执行 |
还有个体感来源值得知道:连续快速滚动时会自动切到「快速滚动」曲线放大加速度,触发阈值与放大倍率随动画曲线不同而不同——滚动「跟手又克制」的感觉就是这么来的。
实战技巧
按住侧键拖拽管理窗口
「Scroll & Navigate」的双指滑动模拟同样能喂给窗口管理工具:把某个按钮的 Click and Drag 设成该动作,按住拖拽即可把窗口吸附到半屏、四分之一屏或全屏(作者推荐搭配 Swish)。触控板双指滑动能做的事,这套组合基本都能复刻。
把亮度、音量键绑到鼠标上
按键选择器可选键盘上任意键,包括只出现在 Apple 键盘上的亮度、音量、媒体播放等特殊功能键。手头没有 Apple 键盘时,在选择器里按住 Option(⌥)就能列出这些键。
用拖拽手势触发 App Exposé
把某个按钮设为「Spaces & Mission Control」后向下拖拽,可打开 App Exposé。若无效,多半是系统侧手势被禁用了,终端执行:
defaults write com.apple.Dock showAppExposeGestureEnabled -bool TRUE; killall Dock临时关掉某个功能
在 General 页打开 Show in Menu Bar,就能从菜单栏随时开关平滑滚动、按键重映射。这是「按应用配置」功能落地前的过渡方案。
常见问题排障
单击总是慢半拍
现象:单击后动作有明显延迟。成因:Mac Mouse Fix 需要短暂等待以判断你是否要双击,判定窗口在 GeneralConfig.swift 中配置得很短,但仍可感知。处理:删掉该按钮上所有「Double Click」动作即可恢复即时单击。
部分按键不被识别
现象:某些鼠标的按键抓不到。成因:这类鼠标(常见于搭配 Logitech Options 等专有驱动的产品)用厂商私有协议而非标准 USB 协议通信,按键信号不经过标准通道。处理:换用标准协议的鼠标,或干脆不给该键绑定动作。
按键被捕获后其他软件失效
现象:终端里中键粘贴不可用、Blender 中键拖拽转视角失灵。成因:该按键已被 Mac Mouse Fix「捕获」,捕获后其他应用不再能看到这个按键,界面会弹出提示:
处理:移除该按钮的全部动作即可释放捕获;或改用等价手势,比如用「Scroll & Navigate」代替中键拖拽来转视角。
卸载后残留文件
现象:应用拖进废纸篓后系统里仍有配置文件。成因:设置以 plist 持久化,macOS 不允许应用被删除后自行清理残留。处理:用 AppCleaner 一类工具清扫残留。
指针加速度关不掉
现象:应用内没有对应开关。处理:macOS 14 Sonoma 及以上可在「系统设置 > 鼠标 > 高级… > 指针加速度」中关闭。
Magic Mouse 没有任何效果
这是预期行为:Mac Mouse Fix 目前对 Magic Mouse 不生效,不算故障。
选型参考:系统版本、价格与授权
| 系统范围 | 对应版本 | 注意事项 |
|---|---|---|
| macOS 11 Big Sur 及以上 | 最新 3.x | Apple Silicon 原生运行 |
| macOS 10.13–10.15 | Mac Mouse Fix 2 最新版 | 3.0 及以上在这些系统上有显示异常,部分功能可能失效 |
| macOS 10.11–10.12 | 2.2.0 及以下 | 较老版本 |
价格与授权要点:
- Mac Mouse Fix 2 及更早版本永久免费;
- Mac Mouse Fix 3 提供 30 天免费试用,之后一次性买断。一份授权覆盖你所有的 Mac,同一 Apple 账户下经 iCloud 自动同步,覆盖全部 3.x 版本(未来 4.0 等大版本可能需重新购买);
- 无正式退款政策,但可用足 30 天试用;应用无广告、不收集个人信息(购买环节销售平台会留存邮箱用于发授权码);
- 3.x 起采用项目自己的 MMF License,仍然开源,允许你把源码用于自己的项目,只要不直接发布一份简单副本。
参与项目
- 反馈:通过官方反馈渠道提交 bug 与功能建议;作者明确表示在「按应用配置」功能落地前,很想听到你的真实使用场景。
- 翻译:项目已支持二十多种语言(含简体中文),可参与翻译或报告缺失、不理想的译文。
- 代码:欢迎提交 pull request。如果不确定改动方向会被采纳,可先提交一个只描述改动方案、几乎不含代码的 PR,让作者确认方向后再动手。
- 支持:在应用内购买,或通过 GitHub 按月赞助开发者。
写在最后
Mac Mouse Fix 用「主应用管配置 + Helper 后台处理事件」的双进程架构,把平滑滚动、手势模拟和按键重映射封装成了几个直观的选项卡,是普通鼠标在 Mac 上最省事的升级路径 🖱️。想深入时,从 Shared/Config/default_config.plist、Helper/Core/Config/ScrollConfig.swift 和 Helper/Core/Actions/Actions.h 这三个入口读起即可。
【免费下载链接】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),仅供参考