OpenPets跨平台打包与代码签名：Windows/macOS/Linux发布分发完整指南
2026/10/16 2:23:04
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 应用，它接管你的鼠标滚轮和按键，把平滑滚动、双指式拖拽和自定义侧键动作装进一只普通鼠标里。读完本文，你能完成安装、授权和第一组侧键映射，并知道哪些功能它给不了。
一、对号入座：你的鼠标是不是也这样
先别急着装。对照下面这张表，看看有几条戳中你——戳中两条以上，Mac Mouse Fix 基本就是为你写的。
| 你遇到的情况 | 背后原因 | Mac Mouse Fix 能做什么 |
|---|---|---|
| 网页和文档滚动一顿一顿的 | macOS 对非 Apple 设备的滚轮事件做了"整格量化" | 滚动标签页里开启平滑滚动，配合曲线与惯性，滚起来接近触控板 |
| 鼠标上的侧键永远闲置 | 系统没有给鼠标侧键安排正经工作 | 按键标签页里把 Button 4 / Button 5 映射成快捷键、系统动作或键盘按键 |
| 窗口贴边切空间、滑动前进后退要靠触控板 | 这些是双指手势专属 | 某个按键设为"点按并拖移 + 滚动与导航"后，用鼠标也能触发 |
| 想一键调亮度或切歌，手离开键盘太麻烦 | 苹果专属功能键在第三方键盘上不存在 | 给鼠标按键直接指派亮度、媒体播放等苹果键盘功能键 |
| 中键、双击中键这类"复合动作"想自定义 | 系统不提供鼠标按键的自定义入口 | 同一颗按键可同时挂"点按""点按并拖移"等多组动作，还兼容按键组合 |
一条都不沾？那它对你意义不大，往下看第二章装不装随你。
二、从安装到第一次见效
整条主线四步，全程不超过五分钟。
第1步，安装。习惯命令行的，终端里敲：
brew install mac-mouse-fix也可以从官网下载 .dmg 手动安装，两条路线装出来的应用行为一致。
第2步，授予辅助功能权限。打开系统设置 > 隐私与安全性 > 辅助功能，找到 Mac Mouse Fix 并勾选。没有这一步，后面全是空谈——应用根本收不到鼠标事件，所有映射都是摆设。勾选后如果界面上提示需要重启应用，照做即可。
第3步，打开主开关。启动应用，在通用标签页把Enable Mac Mouse Fix开关拨到开启。真正接管鼠标的是后台的 Helper 进程，这个开关决定它跑不跑；关掉应用窗口不影响它继续工作。
第4步，捕获第一颗侧键。切到按键标签页，把指针移进上方大号"+"区域，按一下鼠标侧键（比如 Button 4），它就会出现在下方列表里。接着在这一行右侧的下拉框里选一个动作，比如启动台。再按一下 Button 4 验证——弹出来了，这颗键就是你的了。
三、高频场景：装完之后最常被用到的四个
滚轮平滑滚动
最多人装它就是为了这个。进滚动标签页，打开平滑滚动，再按需调Sensitivity（灵敏度）和曲线。配完的效果：无论你的鼠标滚轮原始分辨率多粗糙，页面滚动都变成连续匀速的，惯性滑动也接近触控板的手感。曲线选项里有多条预设，默认值先跑两天，觉得快或慢再微调。
侧键变身快捷键与系统动作
给闲置的 Button 4 / Button 5 找到工作。在按键标签页捕获侧键后，下拉框里可选的动作覆盖三类：系统动作（启动台、调度中心等）、模拟键盘按键、以及前进后退这类通用动作。配完的效果：一键开启动台、一键前进后退网页，手指不用离开鼠标。想组合着用也可以——同一颗键支持"点按"和"连按 + 点按"多组动作并存，互不干扰。
"点按并拖移"复刻双指滑动
用一只鼠标做出触控板手势。给某颗按键的点按并拖移选滚动与导航，之后按住这颗键在桌面上拖，效果等同在触控板上双指滑动：窗口贴边吸附切空间、左右拖动切换前进后退、3D 软件里拖出轨道视角。配完的效果：以前必须回到触控板才能完成的手势，现在在鼠标上按住拖就行。
鼠标接管苹果键盘的专属功能键
键盘上没有的键，让鼠标来补。选"键盘按键"类动作时按住Option (⌥)，下拉列表会展开苹果键盘专属功能键：屏幕亮度、音量、媒体播放控制等。配完的效果：剪辑或投屏时按一下鼠标侧键就能调亮度，不用回头找键盘。
四、边界与代价：它管不了什么
收益说完，把坑摊开讲。
- "捕获"是独占，代价同样直接。按键被捕获后，macOS 和其他软件都看不见它。也就是说：浏览器里中键打开新标签、部分游戏对侧键的原生支持，在你捕获它们之后都会消失。想给某颗键"还魂"，要么清空它名下所有动作彻底释放捕获，要么干脆关掉主开关。
- 苹果妙控鼠标不受影响。官方明确说目前没有对 Magic Mouse 生效的功能，买的是 Magic Mouse 的话先别抱期望。
- 专有协议鼠标有识别上限。走罗技 Options 这类专有协议的机型，部分按键可能识别不到。卸载厂商驱动软件后重试，个别键仍可能缺失。
- 系统版本有硬门槛。最新版要求macOS 11 Big Sur或更高；10.15 / 10.14 / 10.13 用 Mac Mouse Fix 2 的最后一个版本；10.12 / 10.11 需要 2.2.0 或更早。
- 还不能按应用区分配置。第 3 代暂时没有 App-specific settings，同一个配置全局生效。临时方案：在通用标签页打开Show in Menu Bar，需要某个应用"纯净鼠标"时直接从菜单栏关掉平滑滚动等功能。
- 指针加速关不掉（在它内部）。它本身不提供关闭 pointer acceleration 的开关，macOS 14 Sonoma 及以上可以自己在系统设置 > 鼠标 > 高级…里关。
五、问题速查 🛠️
装完用着不对劲，先查这张表。
| 症状 | 原因 | 处理动作 |
|---|---|---|
| 所有映射一律没反应 | 辅助功能没勾，或勾完没重启应用 | 回系统设置 > 辅助功能确认勾选，然后完全退出（⌘Q）再打开 Mac Mouse Fix |
| 以前好好的，突然不灵了 | 厂商驱动软件（如 Logi Options）在抢按键 | 退出或卸载厂商软件再试；仍不行就用 Console.app 翻系统日志找报错 |
| 按一下有明显延迟 | 这颗键挂了"双击"类动作，系统在等第二下 | 删掉该按键的Double Click动作，延迟立刻消失 |
| 个别按键根本识别不到 | 专有协议鼠标的已知上限 | 卸载厂商驱动软件重试；不行就换一颗标准协议的鼠标验证 |
| 中键又能开链接了、游戏侧键"复活"了 | 捕获被清空或被别的软件抢回 | 回按键标签页重新捕获该按键并挂回动作 |
| 想彻底释放某颗键 | 名下还有残留动作行 | 在该分组下逐一点掉每行左侧的−，清空即释放；别误碰右下角恢复默认值…，那会重置全部设置 |
备份配置很简单，整个设置就一个文件：
# 备份到桌面 cp ~/Library/Application\ Support/com.nuebling.mac-mouse-fix/config.plist ~/Desktop/mmf-backup.plist # 换机后恢复 cp ~/Desktop/mmf-backup.plist ~/Library/Application\ Support/com.nuebling.mac-mouse-fix/config.plist现在就可以动手做的
- 用
brew install mac-mouse-fix装好，在辅助功能里完成授权，打开Enable Mac Mouse Fix主开关。 - 只给 Button 4 / Button 5 各配一个动作，先跑一天再扩展。
- 在滚动标签页开平滑滚动，把灵敏度调到顺手的程度。
- 试一次"点按并拖移 + 滚动与导航"，感受鼠标上的双指滑动。
- 把
config.plist复制一份到桌面或网盘，换机直接还原。
💡 小贴士：第一次只配两颗侧键加平滑滚动，用一整天，手感确认合适了再往完整方案扩——配置集中在一个 plist 文件里，改起来随时可回退，但改得越多回退越费劲。
资源入口：
- 按键、滚动、平滑等核心处理逻辑：Helper/Core/
- 配置文件结构与默认参数：Shared/Config/
- 官方按键捕获机制说明：Support/Guides/CapturedButtonsMMF3.md
【免费下载链接】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），仅供参考