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-fix

滚轮一格一格地跳、鼠标侧键吃灰大半年、Mac 键盘连亮度键都没有——如果这些里有一样戳中你，可以看看 Mac Mouse Fix：这款开源工具把闲置的鼠标按键变成独立动作，靠鼠标按键自定义，让普通鼠标也有触控板级的拖拽手感。

Mac Mouse Fix 怎么安装、辅助功能权限在哪开

最短路径是 Homebrew，一条命令装、一条命令升级：

brew install mac-mouse-fix brew upgrade mac-mouse-fix

也可以从官网下载 .dmg（版本最新，偏好设置里能开测试版通道，但升级要手动重新下载），或从 App Store 安装（受沙盒限制，部分系统级鼠标功能可能用不了，更新也偏慢）。三条路线用起来没有区别：配置都存在~/Library/Application Support/Mac Mouse Fix下，装完后的第一件事也相同——授权。

打开系统设置 > 隐私与安全性 > 辅助功能，找到 Mac Mouse Fix 并勾选。这个勾是应用接收鼠标事件的入口，不勾的话，后面配的映射全部收不到事件，纯属白忙。勾选后记得完全退出并重开应用再验证。

侧键映射怎么配：从三个常见效果入手

效果一：普通鼠标拖出触控板的手感

进入按键标签页，把鼠标指针移进大号"+"区域，按下你想改造的侧键，再从右侧下拉框里选动作。把某个按钮的点按并拖移目标设为滚动与导航，就是 Mac 触控板拖拽的核心玩法：窗口贴边切换空间、左右滑动前进后退，整套手势都能用。下方截图是一套完整的示例配置——中键给智能缩放，按住 Button 5 再点中键给调度中心，Button 4 挂启动台与滚动导航。

验证也最朴素：配完按一下那颗键，动作弹出来就算成了。

效果二：用鼠标补上键盘没有的功能键

选键盘按键类动作时，按住Option (⌥)，苹果键盘的专属功能键会浮出来——屏幕亮度、媒体播放控制等。剪辑或投屏时调亮度不用回头找键盘，按一下就完事。

效果三：多颗侧键与组合键一起管理

按键挂多了也别慌。同一颗按钮可以同时挂点按、点按并滚动、点按并拖移三种动作；按住 Button 5 再点中键算一个组合，单独点中键算另一个，互不干扰。先给 Button 4 挂个单击动作、按一下验证，手感确认后，这颗侧键就正式归你使唤了。

"捕获"到底是什么：独占接管与它的边界

捕获说白了就是独占。按钮被接管后，macOS 和其他软件都看不见这颗键，你的自定义动作不必再跟系统行为"抢地盘"，触发得干净利落。但代价同样明确：原本依赖这颗键的原生行为会失效——浏览器里中键点开链接、部分游戏对侧键的原生支持，在捕获期间都用不了。

动手前也确认下适用范围：最新版要求 macOS 11 Big Sur 或更高，10.15 / 10.14 / 10.13 建议用 Mac Mouse Fix 2 末版，10.12 / 10.11 则需要 2.2.0 或更早版本。两个已知限制：苹果妙控鼠标不受这款工具影响；个别走专有协议的罗技机型，部分按键可能识别不到。

映射失灵怎么排查 🔍

出了问题不用慌，按下面顺序递进着查：

先查权限。辅助功能勾了吗？勾选后有没有完全退出重开应用？这两项缺一个，所有功能都不工作。
再查冲突。之前正常、突然失效，多半是 Logi Options 这类厂商软件在抢占按键；可以打开 Console.app 翻一下系统日志有没有报错。
最后查单颗键。按下去有瞬间延迟，通常是该按钮挂了"双击"类动作，系统在等你按第二下——删掉延迟即消失。如果浏览器里中键突然又能打开链接、游戏里侧键又"活"了，说明捕获没成功或被别的软件抢回，回按键标签页对该按钮重新捕获一次即可。

想把某颗键还给系统：在该分组下逐一点掉每个动作行左侧的−，清空即释放。别误点右下角的恢复默认值…——那会重置全部设置，动手前先备份。

备份 default_config.plist，今天就动手

建议先只配两颗侧键，用一整天，手感确认合适再扩展到完整方案——后面改起来最省事。全部设置集中在default_config.plist，备份与恢复就是复制一个文件：

cp ~/Library/Application\ Support/Mac\ Mouse\ Fix/default_config.plist ~/Desktop/mmf-backup.plist # 在新设备恢复 cp ~/Desktop/mmf-backup.plist ~/Library/Application\ Support/Mac\ Mouse\ Fix/default_config.plist

资源入口：