# MouseFix
**Repository Path**: Matreshka15/MouseFix
## Basic Information
- **Project Name**: MouseFix
- **Description**: 🖱️ 鼠标双击、滚轮乱跳？一招搞定！超轻量级 Windows 工具，免费开源，完全不影响系统。🚀
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://zhuanlan.zhihu.com/p/1997332644929757926
- **GVP Project**: No
## Statistics
- **Stars**: 22
- **Forks**: 2
- **Created**: 2026-01-22
- **Last Updated**: 2026-01-30
## Categories & Tags
**Categories**: application-software
**Tags**: None
## README
# MouseFix
**让你的鼠标不再误触 —— 一键解决双击和滚轮故障**
[English](README.md) | [🚀 快速开始](#快速开始) | [📥 下载](#下载)
---
## 🎯 什么是 MouseFix？
**解决这些烦人的鼠标问题：**
- 😤 **双击变单击**或单击变双击
- 😤 **滚轮乱跳或反向滚动**
- 😤 **鼠标按键不灵敏**
- 😤 **误触影响工作效率**
**问题根源？**
大多数情况下是"开关回弹"问题——鼠标的微动开关老化，触点接触不稳定，导致一次点击被识别为多次。这是硬件问题，但 MouseFix 可以用软件解决！
**MouseFix 解决方案：**
- ✅ **智能过滤误触**：通过时间阈值过滤掉短时间内重复的点击
- ✅ **滚轮防抖**：防止滚轮反向滚动和跳页
- ✅ **即插即用**：无需配置，默认设置即可生效
- ✅ **零干扰**：静默运行，不影响正常使用
- ✅ **完全免费**：开源软件，永久免费使用
---
## ✨ 核心功能
### 🎯 全方位保护
- **支持所有鼠标按键**：左键、右键、中键、侧键（X1/X2）和滚轮
- **滚轮防抖**：防止滚轮反向滚动和跳页
- **高性能优化**：使用缓存行对齐技术，CPU 占用极低
- **静默运行**：不产生日志文件，不干扰正常使用
### 🎨 简单易用的界面
- **系统托盘集成**：静默运行在通知区域，不占用桌面空间
- **右键菜单配置**：所有设置都可以通过右键菜单快速访问
- **可视化反馈**：勾选标记清晰显示已启用的按键
- **实时统计**：查看已拦截的误触事件数量
### ⚡ 三种预设模式，一键切换
| 预设模式 | 按键阈值 | 滚轮阈值 | 适用场景 |
|---------|---------|---------|---------|
| 🎯 **默认模式** | 60ms | 30ms | 日常使用，平衡性能和灵敏度 |
| 💼 **办公模式** | 80ms | 40ms | 文档编辑、表格处理，更严格过滤 |
| 🎮 **严格模式** | 40ms | 20ms | 精密操作、游戏，快速响应 |
### 🔧 独立控制每个按键
你可以为每个鼠标按键单独设置：
- ✓ 左键（最常用的按键）
- ✓ 右键（上下文菜单）
- ✓ 中键（滚轮点击）
- ✓ X1 键（后退/侧键）
- ✓ X2 键（前进/侧键）
- ✓ 滚轮滚动
---
## 📥 下载
### 最新版本
[查看所有版本](https://github.com/matreshka15/MouseFix/releases)
**选择哪个版本？**
- **64位版本**：适合大多数现代电脑（推荐）
- **32位版本**：适合较旧的 32 位系统
---
## 🚀 快速开始
1. **下载**并解压 MouseFix（推荐 64位版本）
2. **运行** `MouseFix.exe` - 程序出现在系统托盘中
3. **右键点击**托盘图标进行配置：
- 切换按键（左键、右键、中键、X1、X2、滚轮）
- 选择预设（默认/办公/严格）或自定义阈值
4. **退出**时右键点击托盘图标
**注意：** 程序只能运行一个实例，设置在重启后恢复默认值。
---
## 🔧 开机自启动配置
使用提供的 PowerShell 脚本轻松配置 MouseFix 开机自启动：
1. **运行** `add_to_startup.ps1`（右键选择"使用 PowerShell 运行"）
2. **选择**启动方式：
- **启动文件夹**（推荐）- 易于管理，可在启动应用中查看
- **注册表** - 隐藏的系统级启动
3. **完成** - MouseFix 将在下次登录时自动启动
如需取消自启动，再次运行脚本并选择"取消自启动"。
**提示：** 按 `Win+R` 并输入 `shell:startup` 可查看启动文件夹内容。
---
## ❓ 常见问题
**Q: 程序运行后仍然有误触怎么办？**
A: 切换到 **办公模式**（80ms）或自定义阈值为 100-150ms。
**Q: 滚轮滚动感觉有延迟怎么办？**
A: 禁用滚轮防抖（取消勾选 Wheel）或将滚轮阈值降低到 20ms。
**Q: 程序无法启动，提示"MouseFix is already running!"？**
A: 检查系统托盘中是否已有 MouseFix 图标。如果没有，重启电脑即可。
**Q: 每次重启电脑后设置都重置了？**
A: 当前版本不保存设置，每次关闭后需要重新配置，或添加到开机启动项。
**Q: 杀毒软件报警怎么办？**
A: 添加到杀毒软件白名单。程序使用系统级鼠标钩子，但不会收集数据。
---
## 📄 开源协议
本项目采用 MIT 开源协议，详见 [LICENSE](LICENSE) 文件。
---
## 🙏 致谢
- **原始概念**：[marvinlehmann](https://github.com/marvinlehmann)
- **分支改进**：[matreshka15](https://github.com/matreshka15)
---
**如果 MouseFix 帮到了你，请给我们一个 ⭐ Star！**
[回到顶部](#mousefix)