C语言实现Windows鼠标模拟器：底层API调用与自动化测试实践

1. 项目概述：一个Windows下的C语言鼠标模拟器

最近在整理一些自动化测试和演示工具的代码库时，翻到了一个挺有意思的小项目：savazeb/cursor。这是一个用纯C语言编写的Windows鼠标光标移动模拟器。它的核心功能很简单，就是让鼠标指针在屏幕上平滑地、随机地移动。听起来可能有点“无聊”，但这个小工具在实际开发中，尤其是在需要模拟用户交互、进行UI自动化测试、或者制作演示视频防止系统锁屏的场景下，其实非常有用。

很多朋友在做自动化脚本或者测试框架时，可能会直接调用一些高级语言（如Python）的库，比如pyautogui。但有时候，我们需要一个更底层、更轻量、不依赖庞大运行时环境的原生解决方案。这个C语言项目就提供了这样一个选择。它直接调用Windows API，通过控制鼠标输入设备，实现了从当前光标位置到随机目标位置之间的平滑移动动画。对于想了解Windows底层输入模拟机制，或者需要将类似功能嵌入到C/C++项目中的开发者来说，这是一个很好的学习范本和实用起点。

2. 核心原理与Windows API解析

要理解这个模拟器是如何工作的，我们得先拆解一下在Windows系统下，程序是如何控制鼠标的。整个过程不涉及任何硬件驱动，完全是基于操作系统提供的软件接口。

2.1 核心API：SetCursorPos与GetCursorPos

Windows为应用程序控制鼠标提供了user32.dll中的一组API。这个项目最核心的两个函数是：

1. GetCursorPos：这个函数的作用是获取当前鼠标光标在屏幕坐标系中的位置。它接受一个指向POINT结构体的指针作为参数，调用成功后，该结构体的x和y成员就会被填充为光标当前的像素坐标。屏幕坐标系的原点(0, 0)通常位于屏幕的左上角，X轴向右递增，Y轴向下递增。

2. SetCursorPos：与GetCursorPos相反，这个函数用于设置鼠标光标的位置。它接受两个整数参数X和Y，调用后，系统会立即将光标移动到指定的屏幕坐标。需要注意的是，这是一个“瞬移”操作，光标会直接从A点跳到B点，没有中间过程。

如果只使用SetCursorPos，我们只能实现光标的“跳跃”。为了让移动看起来是“平滑”的，就需要在这两个点之间插入许多个中间点，并依次调用SetCursorPos，在极短的时间内连续移动，利用人眼的视觉暂留效应，形成动画效果。这就是项目中“步进”（STEPS）参数的意义。

2.2 平滑移动的算法实现

平滑移动的本质是线性插值。假设起点是(startX, startY)，随机生成的目标点是(targetX, targetY)。我们将从起点到终点的路径等分为STEPS份。

对于每一步i（从0到STEPS），光标的位置(currentX, currentY)可以通过以下公式计算：

currentX = startX + (targetX - startX) * (i / STEPS) currentY = startY + (targetY - startY) * (i / STEPS)

当i = STEPS时，位置正好就是(targetX, targetY)。

程序在循环中，计算出一个中间点，就调用一次SetCursorPos，然后通过Sleep(STEPSTIME)函数暂停一小段时间（例如10毫秒），接着计算并移动到下一个点。这样，我们就得到了一段从起点平滑移动到终点的动画。

2.3 屏幕边界与随机坐标生成

为了保证光标始终在可见的桌面区域内移动，程序需要知道屏幕的尺寸。这可以通过GetSystemMetricsAPI来获取：

• GetSystemMetrics(SM_CXSCREEN)：返回屏幕的宽度（像素）。
• GetSystemMetrics(SM_CYSCREEN)：返回屏幕的高度（像素）。

在生成随机目标位置时，程序会利用rand()函数生成一个介于0到SCREENWIDTH-1之间的随机数作为X坐标，以及一个介于0到SCREENHEIGHT-1之间的随机数作为Y坐标。这样就确保了目标点不会跑到屏幕外面去。

注意：这里有一个常见的细节问题。rand()函数生成的随机数范围是0到RAND_MAX。为了将其映射到屏幕宽度[0, width)，标准的做法是使用取模运算：rand() % width。但更均匀的做法是使用(int)((double)rand() / RAND_MAX * width)，不过对于鼠标移动模拟这种场景，取模运算的精度已经足够。

3. 代码结构深度解析与编译指南

原项目的代码结构非常清晰，主要分为两个文件：main.c和cursor.c。我们来看看每个文件的具体职责和里面的关键代码。

3.1cursor.h与cursor.c：功能模块封装

通常，一个设计良好的C项目会有对应的头文件（.h）来声明函数和数据结构。虽然原README没有提及，但合理的做法是创建一个cursor.h。

cursor.h(推测内容)

#ifndef CURSOR_H #define CURSOR_H // 初始化函数，例如设置随机种子 void init_cursor_simulator(void); // 核心移动函数：从当前位置平滑移动到指定目标点 void move_cursor_smoothly(int targetX, int targetY, int steps, int stepDelayMs); // 便捷函数：移动到随机位置 void move_cursor_to_random_position(int steps, int stepDelayMs); #endif // CURSOR_H

cursor.c：功能实现这个文件包含了所有与鼠标操作和移动逻辑相关的函数定义。

1. 初始化与随机种子： 在C语言中，rand()函数生成的是伪随机数序列，如果不初始化随机种子，每次程序运行生成的序列都是一样的。通常我们会用当前时间作为种子。这在init_cursor_simulator函数中完成。

   #include <stdlib.h> #include <time.h> #include <windows.h> void init_cursor_simulator() { srand((unsigned int)time(NULL)); // 用当前时间初始化随机数生成器 }

2. 核心移动函数move_cursor_smoothly： 这是算法的核心实现。它接收目标坐标、步数和步进延迟作为参数。

   void move_cursor_smoothly(int targetX, int targetY, int steps, int stepDelayMs) { POINT startPos; GetCursorPos(&startPos); // 获取起点 for (int i = 1; i <= steps; i++) { // 线性插值计算当前步的位置 double ratio = (double)i / steps; int currentX = startPos.x + (int)((targetX - startPos.x) * ratio); int currentY = startPos.y + (int)((targetY - startPos.y) * ratio); SetCursorPos(currentX, currentY); // 移动光标 Sleep(stepDelayMs); // 等待 } // 循环结束后，确保光标精确到达目标点（防止浮点数计算误差） SetCursorPos(targetX, targetY); }

   实操心得：在循环结束后，我习惯性地再加一句SetCursorPos(targetX, targetY)。这是因为浮点数计算和整数转换可能产生一个像素以内的误差，最后强制定位一下可以确保准确性。虽然对于鼠标移动来说一两个像素的误差人眼几乎无法察觉，但在要求精确的自动化测试中，这个习惯很重要。

3. 随机移动函数move_cursor_to_random_position： 这个函数封装了获取屏幕尺寸、生成随机坐标并调用平滑移动的过程，是给主循环调用的便捷接口。

   void move_cursor_to_random_position(int steps, int stepDelayMs) { int screenWidth = GetSystemMetrics(SM_CXSCREEN); int screenHeight = GetSystemMetrics(SM_CYSCREEN); // 生成屏幕范围内的随机坐标 int targetX = rand() % screenWidth; int targetY = rand() % screenHeight; move_cursor_smoothly(targetX, targetY, steps, stepDelayMs); }

3.2main.c：程序入口与主循环

这个文件包含了程序的入口点main函数，负责控制整个程序的流程。

#include <windows.h> #include “cursor.h” // 引入我们自己的模块 // 可配置的参数，通常定义为宏或全局变量 #define STEPS 50 #define STEPSTIME 10 // 毫秒 int main() { // 初始化 init_cursor_simulator(); // 主循环：持续随机移动 while (1) { move_cursor_to_random_position(STEPS, STEPSTIME); // 两次移动之间的间隔。可以加上，避免移动过于频繁。 // Sleep(1000); // 等待1秒后再进行下一次移动 } return 0; // 实际上，上面的无限循环不会执行到这里 }

3.3 编译与运行实战

原README给出了使用GCC编译的命令。在Windows上，你可以使用MinGW-w64提供的GCC工具链。

1. 安装编译环境： 如果你没有C编译器，推荐安装 MSYS2 ，它提供了优秀的MinGW-w64环境。安装后，在MSYS2终端中运行pacman -S mingw-w64-ucrt-x86_64-gcc来安装64位的GCC。

2. 编译命令详解：

   gcc -o cursor.exe main.c cursor.c

   • gcc: GNU C编译器。
   • -o cursor.exe:-o参数指定输出的可执行文件名。
   • main.c cursor.c: 列出所有需要编译的源文件。编译器会分别编译它们，然后链接在一起。

3. 链接Windows库： 上面的命令在MSYS2的MinGW环境下可以正常运行，因为GCC默认会链接必要的系统库。如果你在其它环境遇到“undefined reference toSetCursorPos”等链接错误，说明没有自动链接user32.dll。你需要显式指定链接这个库：

   gcc -o cursor.exe main.c cursor.c -luser32

   -luser32就是告诉链接器去查找并链接名为libuser32.a的库文件，它包含了SetCursorPos,GetCursorPos等API的定义。

4. 运行与停止： 编译成功后，在命令行中直接运行cursor.exe。你会看到鼠标光标开始自动在屏幕上平滑地游走。要停止程序，需要切换到命令行窗口，按Ctrl + C强制中断。因为程序是一个无限循环，没有内置的退出机制。

4. 参数调优与高级用法探讨

项目的可配置参数虽然只有几个，但不同的组合会产生截然不同的效果。理解这些参数，能让你更好地将这个工具应用到具体场景中。

4.1 核心参数作用解析

参数名	含义	默认值（示例）	影响与调优建议
STEPS	单次移动的步进数。	50	值越大，移动轨迹越平滑，但单次移动耗时越长。对于演示或防止锁屏，30-50步足以形成平滑效果。对于需要快速移动的测试，可以降低到10-20步。
STEPSTIME	每步之间的延迟（毫秒）。	10 ms	值越大，移动速度越慢。移动总耗时 ≈ STEPS * STEPSTIME。例如50步*10ms=500ms完成一次移动。要模拟人类较快的鼠标移动，可以设为5-15ms；模拟缓慢移动或精确拖拽，可以设为20-50ms。
移动间隔	两次随机移动之间的等待时间。	无（代码中注释了）	在主循环的move_cursor_to_random_position调用后添加一个Sleep(间隔时间)。这个参数决定了鼠标的“活跃度”。防止锁屏通常需要每分钟都有操作，所以间隔可以设为30-60秒。自动化测试可能希望连续移动，可以不设间隔或设一个很短的值（如100ms）。

4.2 扩展功能实现思路

这个基础框架可以很容易地扩展出更复杂的功能：

1. 绘制特定轨迹： 不仅仅是随机移动，我们可以让鼠标画出图形。修改主循环，将随机坐标生成替换为按照数学公式计算的坐标序列。

   // 示例：画一个圆形轨迹 int centerX = screenWidth / 2; int centerY = screenHeight / 2; int radius = 200; for (int angle = 0; angle < 360; angle += 5) { // 5度一个点 double radian = angle * 3.14159 / 180; int targetX = centerX + (int)(radius * cos(radian)); int targetY = centerY + (int)(radius * sin(radian)); move_cursor_smoothly(targetX, targetY, STEPS, STEPSTIME); }

   需要包含数学库#include <math.h>，并在编译时加上-lm参数链接数学库。

2. 模拟点击与拖拽： 只移动不够？Windows API同样提供了模拟鼠标按键的函数：mouse_event或更现代的SendInput。

   • mouse_event：这是一个较老的API，但简单易用。可以模拟左键按下(MOUSEEVENTF_LEFTDOWN)、释放(MOUSEEVENTF_LEFTUP)，右键、中键等操作。
   • SendInput：这是更推荐的方式，它可以模拟更复杂的输入序列，并且是mouse_event的替代品。 你可以在移动到特定位置后，调用这些函数来模拟点击行为。

3. 读取配置文件： 将STEPS、STEPSTIME等参数硬编码在代码里不方便。可以设计一个简单的配置文件（如config.ini）或通过命令行参数来传递。使用getopt（Windows下是getopt.h或自行解析）来处理命令行参数会非常专业。

4. 优雅退出机制： 无限循环不是个好习惯。可以增加一个退出条件，例如：

   • 监听键盘热键：使用GetAsyncKeyState函数检测某个键（如ESC）是否被按下，如果按下则跳出循环。
   • 运行指定时长：在程序开始时记录时间，主循环中检查是否超过了预设的运行时间（如10分钟）。
   • 移动指定次数：设置一个计数器，完成一定次数的移动后退出。

5. 常见问题与排查技巧实录

在实际编译、运行和扩展这个项目的过程中，你可能会遇到一些问题。下面是我遇到过的一些典型情况及其解决方法。

5.1 编译与链接问题

问题1：undefined reference to ‘SetCursorPos’或类似错误。

• 原因：编译器找不到Windows API函数的实现。这些函数存在于系统动态链接库（DLL）中，但需要通过对应的导入库（.a或.lib文件）来链接。
• 解决：在GCC编译命令末尾显式添加-luser32。对于MinGW，user32是包含GUI相关函数的库。

  gcc -o cursor.exe main.c cursor.c -luser32

  如果还使用了其他API，如Sleep（在-lwinmm或-lkernel32中），可能也需要链接相应的库。Sleep通常来自kernel32，但MinGW的GCC一般会自动链接它。

问题2：warning: implicit declaration of function ‘GetCursorPos’。

• 原因：没有包含正确的头文件。GetCursorPos和SetCursorPos函数声明在windows.h中。
• 解决：确保在使用了这些函数的源文件（cursor.c和main.c）的开头，都包含了#include <windows.h>。

问题3：使用math.h函数（如cos,sin）时链接错误。

• 原因：数学函数在独立的数学库中。
• 解决：在编译命令末尾添加-lm。

  gcc -o cursor.exe main.c cursor.c -luser32 -lm

5.2 运行时行为问题

问题4：鼠标移动“卡顿”或不流畅。

• 原因1：STEPSTIME设置得太小。Sleep函数的精度有限，在Windows上，其实际休眠时间可能比指定的要长，且有一定波动。如果设为1ms，可能实际休眠了10-15ms，导致计时不准。
• 解决1：将STEPSTIME设置为10ms或以上，这是比较可靠的范围。
• 原因2：系统负载过高。如果CPU占用率100%，线程调度可能会延迟。
• 解决2：这不是程序能完全控制的，但可以尝试适当增加STEPSTIME，给系统留出更多处理时间。

问题5：程序无法用Ctrl+C中断。

• 原因：在某些控制台环境中，如果程序正处在Sleep或类似的阻塞调用中，信号可能无法被立即处理。
• 解决：这不是大问题，多按几次Ctrl+C，或者直接关闭命令行窗口。如果需要更优雅的处理，可以考虑使用SetConsoleCtrlHandler来注册一个控制台事件处理函数，在收到CTRL_C_EVENT时干净地退出循环。

问题6：光标移动到了副屏（多显示器环境下）。

• 原因：GetSystemMetrics(SM_CXSCREEN)获取的是主显示器的分辨率。SetCursorPos的坐标是针对虚拟屏幕的。
• 解决：在多显示器环境下，需要更复杂的处理。可以使用GetSystemMetrics(SM_CXVIRTUALSCREEN)和SM_CYVIRTUALSCREEN获取整个虚拟屏幕的大小，或者使用EnumDisplayMonitors枚举所有显示器，并在某个显示器范围内生成随机坐标。这是一个进阶话题，如果你的应用场景涉及多屏，需要专门处理。

5.3 防锁屏场景下的注意事项

问题7：用这个程序防止锁屏，但一段时间后系统还是锁屏了。

• 原因：有些系统策略（尤其是企业域环境）不仅检测鼠标移动，还可能检测键盘活动，或者要求的是“交互”而不仅仅是“移动”。单纯的程序模拟鼠标移动可能被识别为非用户交互。
• 解决：可以组合模拟鼠标移动和模拟一次极小幅度的鼠标抖动或一次微小的键盘按键（如SendInput模拟按下再释放一个不常用的键，如VK_SCROLL）。但请注意，在公司IT政策下，使用此类工具前最好确认其合规性。

这个由savazeb/cursor启发的鼠标模拟器项目，虽然代码量不大，但很好地串联了Windows API调用、C语言编程、算法思想和实际应用。从理解原理，到成功编译运行，再到根据自己需求进行修改和扩展，整个过程对于巩固C语言技能和理解操作系统交互来说，是一次非常棒的实践。