Mac Mouse Fix 实操配置指南
2026/9/16 14:49:19 网站建设 项目流程

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

深夜十一点,你在翻一个很长的 PR:滚轮一拧,页面跳三行,停不住;前进后退要腾手去够键盘;鼠标上的两个侧键,一直闲置着。Mac Mouse Fix 是一款 macOS 上的开源鼠标驱动工具,它拦截鼠标事件并按你的规则重新翻译,把普通鼠标的侧键和滚轮变成接近触控板级别的导航工具。

60 秒验证

在终端执行:

brew install mac-mouse-fix

装好启动后,macOS 会请求"辅助功能"权限——去 系统设置 → 隐私与安全性 → 辅助功能勾选,再回到应用里打开"Enable Mac Mouse Fix" 开关。把指针移到"按键"标签页的"+"区域,按一下侧键,看到"按键 X 被 Mac Mouse Fix 捕获到"的提示,说明捕获已经生效。

功能全景

标签页 / 模块能做什么
按键捕获侧键、中键,绑定单击、双击、点按并拖移动作与组合键
滚动把生硬滚轮变成带惯性的平滑滚动,调节加速度与曲线
指针调整指针速度与加速曲线
通用全局启用开关、菜单栏快捷开关、登录项
滚动与导航模拟触控板双指滑移,支持窗口吸附与 3D 视角旋转

分场景实操

侧键映射到浏览器前进后退

目标:看文档、逛代码时不离开鼠标就能前后切换。

  1. 在"按键"标签页把指针移到"+"区域,按一下左侧键(通常是按键 4),列表会自动加一条"按键 4 · 点按"动作项
  2. 在这条动作项右侧下拉里挑目标指令:Safari 后退绑Ctrl + [,前进是Ctrl + ]
  3. 右侧键(按键 5)同样操作,绑定"前进"
  4. 打开一个长网页,交替按两个侧键验证

效果:手不离开鼠标,阅读时的前后切换变成无意识动作。

变体:中键如果原来在浏览器里负责"新标签页打开链接",把它绑成 Mac Mouse Fix 的"中键单击"动作即可恢复原行为;实在不想被接管,点条目左侧的减号删掉动作项,该按键就不再被捕获。

组合键召唤调度中心与启动台

目标:不腾手去按键盘快捷键,直接从鼠标切窗口、切桌面。

  1. 把按键 4 的"点按"设为"启动台"
  2. 把中键的"点按"设为"智能缩放"
  3. 在中键分组里点"+"新增动作项,触发方式选"点按按键 5 + 点按中键"
  4. 给这条组合动作项绑定"调度中心"

效果:单独按中键缩放窗口,先按按键 5 再按中键弹出调度中心,同一个物理键上并存两个动作,组合模式可以无限扩展。

变体:把组合动作绑到"应用 Exposé",呼出当前 App 的窗口列表;若不响应,先在系统设置里启用"应用程序窗口"触控板手势。

点按并拖移模拟触控板滑移

目标:用鼠标完成窗口半屏吸附、3D 视角旋转这类"触控板手势"。

  1. 把按键 4 的"点按并拖移"动作设为"滚动与导航"
  2. 按住按键 4 不放,朝想要的方向拖动
  3. 系统会把它当成触控板双指滑移:配合窗口管理工具可把当前窗口吸到半屏或四分屏,在 Blender 里可环绕模型

效果:原来只有触控板能干的手势,鼠标直接接管。

变体:如果中键原本用于 3D 软件环绕视角、现在被劫持了,删掉它的原绑定,把"点按并拖移"改绑"滚动与导航",环绕手势就回来了。

参数与手感调优

"滚动"标签页里的参数其实分三类:步长决定"每一格有多细",加速度决定"转快时走多远",惯性决定"松手后滑多久"。起步建议保留默认值用一天,再按不顺手的感受调,一次只动一组参数。

  • 如果滚动发"飘"、逐行阅读时停不准,就调低平滑度或关掉惯性,让步长落得更实。
  • 如果长网页翻"太肉",就调高加速度,或把响应曲线往快的一档挪,一口气能滑到底。
  • 如果指针轨迹"跳"、不好控制,去"指针"标签页调速度与加速度;macOS 14 Sonoma 以上还能在系统设置的鼠标选项里直接关闭指针加速。

协同与扩展

第一个组合是窗口管理:把任意按键的"点按并拖移"设为"滚动与导航",再搭配基于手势的窗口管理工具(如 Swish),一点一拖就能把窗口放进半屏、四分屏——触控板的工作流被搬到了鼠标上。

第二个是把键盘的特殊键接到鼠标上:Mac Mouse Fix 允许你把"任意键盘按键"绑给侧键,包括 Apple 键盘才有的亮度、音量、媒体播放键;没有 Apple 键盘时,按住 Option (⌥) 再选键就能看到这些特殊键。

配置迁移不麻烦:所有自定义都存在本机路径~/Library/Application Support/Mac Mouse Fix/下的 plist 文件里,重装前把整个目录拷走做备份,新机器几分钟恢复。想看实现的话,按键与滚动的核心逻辑集中在 Helper/Core/,可克隆仓库到本地研究:

git clone https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix

排障与恢复

症状原因解法
所有功能都不生效辅助功能权限没给系统设置 → 隐私与安全性 → 辅助功能 勾选后重启应用
点击有延迟Mac Mouse Fix 在等判断是否双击删掉该按键的"双击"动作项
某按键在其他软件里失灵按键已被捕获删掉该按键的全部动作项让它回归系统,或用菜单栏快捷开关临时关闭
滚动发"飘"或"肉"参数与手感不匹配在滚动标签页逐一微调曲线与加速度,用长网页实测
按键完全识别不到部分品牌鼠标走私有驱动,未暴露全部按键先在"+"区域确认能否捕获;不行只能换鼠标或等驱动支持

都解决不了时,点应用右下角的"恢复默认值...",把全部设置打回出厂状态;想彻底停止干预,就在"通用"标签页关掉 "Enable Mac Mouse Fix" 开关。

回到那页代码

下次翻长 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),仅供参考

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

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

立即咨询