MouseTester：30秒测出鼠标真实CPI，3分钟拿到轨迹与采样间隔数据-开发者社区

MouseTester：30秒测出鼠标真实CPI，3分钟拿到轨迹与采样间隔数据

【免费下载链接】MouseTester项目地址: https://gitcode.com/gh_mirrors/mo/MouseTester

MouseTester 是一款开源的 Windows 鼠标性能测试工具，它绕过系统指针加速直接读取鼠标原始位移计数，解决"标称CPI是否属实、快速移动时是否存在断帧"这两个只能靠手感判断的问题。

第一次运行：克隆、编译、看到第一个CPI数值

获取项目，在终端执行：

git clone https://gitcode.com/gh_mirrors/mo/MouseTester

编译启动：项目是 .NET Framework 4.6 的 C# WinForms 程序，只能用 Windows 运行。用 Visual Studio 打开 MouseTester.sln 按 F5，或者习惯命令行的话执行msbuild MouseTester.sln /p:Configuration=Release，然后运行 bin 目录下的 MouseTester.exe。
看到第一个结果：点主窗口上的 Measure 按钮，按住鼠标左键在桌面上拉一条 10 厘米的直线再松开，CPI 输入框里就会出现一个整数，这就是这只鼠标的实测CPI。

核心功能走查：按使用频率排序

Measure（测CPI）：产出一个整数CPI，算法是把按住左键期间的所有位移计数平方和开方，再除以 10 厘米（换算为英寸），即"每英寸多少计数"。适合新鼠标到手时核对标称灵敏度是否属实。触发方式：点 Measure，按住左键拉 10 厘米直线，松开即出结果。

Collect（记录一段移动）：产出四个数——事件条数、X/Y 各自的位移（同时给出计数和厘米两种单位）、整段路径总长。适合检查某一段移动是否平滑、有没有丢计数。触发方式：点 Collect，按住左键随意移动，松开后数字就显示在主窗口里。

Log 日志（F1 开始 / F2 停止）：产出一个 CSV 文件，前两行是说明文字和 CPI 值，之后每行是一条事件，列为 xCount,yCount,Time (ms),buttonflags。适合长时间挂着录，捕捉偶发卡顿，文件还能用 Load 按钮读回程序重绘。

Plot 绘图（F3）：把上面的记录画成 8 种图——X/Y 位移对时间、采样间隔对时间、速度对时间（单位 m/s）、以及 X-Y 轨迹散点，下拉框切换类型，还能导出 800×600 的 PNG。

真实使用场景

核对标称CPI是否虚标

场景：新鼠标到手，产品页写着 1600 CPI，想确认是否属实。操作：在同一块鼠标垫上，用 Measure 拉三条 10 厘米直线，取三次结果的均值。可验证效果：三次测量值彼此应接近；用均值对照 1600，偏差的百分比就是这只鼠标的实际误差，可以直接写进购后记录。

找出快速甩动时顿挫的原因

场景：游戏中快速拉枪总觉得一顿一顿的，怀疑是鼠标上报不稳。操作：用 Collect 录一次快速直线甩动，Plot 打开 Interval（采样间隔）图看曲线。可验证效果：1000Hz 回报率的正常间隔应稳定在 1 毫秒上下；曲线若出现明显尖峰或成段跳变，即可复现并保存 CSV 留证。

检查低速微移的轨迹形状

场景：觉得鼠标在慢速移动时方向"发飘"。操作：用 Collect 慢速画一条直线，Plot 切到 X vs. Y 图看散点排布。可验证效果：正常情况散点应排在一条直线上；若明显弯曲或呈蛇形，就是低速漂移的直接证据。

进阶技巧

图表里的绿色平滑线是 8 毫秒（125Hz）时间窗的均值，蓝红散点才是原始数据，看抖动要看散点；配合窗口下方的两个事件序号滑杆，可以把绘图区间收拢到可疑的几十条事件上放大复查，比全览更容易定位。
CPI 输入框支持手填（默认 400）：速度类图表的单位换算依赖这个值，CPI 无效时程序会弹窗拒绝绘图；已知标称值的鼠标直接填入标称值，速度图立刻可用。

实现原理

MouseTester 通过 Windows Raw Input 接口（RegisterRawInputDevices + GetRawInputData）直接订阅鼠标原始位移，不经过系统的指针加速和"鼠标速度"设置，所以读数与系统设置无关。每条事件用 QueryPerformanceCounter 打高精度时间戳，采样间隔图因此反映硬件真实的上报节奏；原始输入的订阅和解包在 Form1 的 WndProc 处理中，CSV 的读写逻辑在 MouseLog 中。