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 视角旋转 |
分场景实操
侧键映射到浏览器前进后退
目标:看文档、逛代码时不离开鼠标就能前后切换。
- 在"按键"标签页把指针移到"+"区域,按一下左侧键(通常是按键 4),列表会自动加一条"按键 4 · 点按"动作项
- 在这条动作项右侧下拉里挑目标指令:Safari 后退绑
Ctrl + [,前进是Ctrl + ] - 右侧键(按键 5)同样操作,绑定"前进"
- 打开一个长网页,交替按两个侧键验证
效果:手不离开鼠标,阅读时的前后切换变成无意识动作。
变体:中键如果原来在浏览器里负责"新标签页打开链接",把它绑成 Mac Mouse Fix 的"中键单击"动作即可恢复原行为;实在不想被接管,点条目左侧的减号删掉动作项,该按键就不再被捕获。
组合键召唤调度中心与启动台
目标:不腾手去按键盘快捷键,直接从鼠标切窗口、切桌面。
- 把按键 4 的"点按"设为"启动台"
- 把中键的"点按"设为"智能缩放"
- 在中键分组里点"+"新增动作项,触发方式选"点按按键 5 + 点按中键"
- 给这条组合动作项绑定"调度中心"
效果:单独按中键缩放窗口,先按按键 5 再按中键弹出调度中心,同一个物理键上并存两个动作,组合模式可以无限扩展。
变体:把组合动作绑到"应用 Exposé",呼出当前 App 的窗口列表;若不响应,先在系统设置里启用"应用程序窗口"触控板手势。
点按并拖移模拟触控板滑移
目标:用鼠标完成窗口半屏吸附、3D 视角旋转这类"触控板手势"。
- 把按键 4 的"点按并拖移"动作设为"滚动与导航"
- 按住按键 4 不放,朝想要的方向拖动
- 系统会把它当成触控板双指滑移:配合窗口管理工具可把当前窗口吸到半屏或四分屏,在 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),仅供参考