1. 项目概述一个让鼠标指针“动起来”的Windows小工具如果你和我一样在Windows系统上工作或学习时偶尔会离开电脑前但又不想让屏幕进入休眠或锁屏状态比如正在下载大文件或者需要保持某个远程会话在线那么你可能会需要一个“屏幕活跃”的模拟器。传统的做法是播放一段视频或者写个脚本定时按一下键盘但这些方法要么占用资源要么不够优雅。今天要聊的这个名为mouse-crawler的小项目就提供了一个非常轻巧且有趣的解决方案它让你的鼠标指针像老式电视的屏幕保护程序一样在屏幕边缘来回弹跳从而模拟用户活动防止系统进入休眠或锁屏状态。mouse-crawler本质上是一个用 C 编写的、仅适用于 Windows 系统的小型命令行工具。它的核心逻辑极其简单——程序启动后会自动接管鼠标移动让指针在屏幕的四个边界之间匀速移动碰到边缘就“反弹”回来。一旦检测到真实的用户输入无论是移动了鼠标还是按下了键盘上的任意键程序就会立刻优雅地退出将控制权交还给用户。这个项目虽然被作者标记为“玩具项目”但其代码简洁、目的明确非常适合 C 初学者学习 Windows API 的基本操作也适合任何需要类似“防休眠”功能的用户直接使用。2. 核心原理与设计思路拆解2.1 为什么选择模拟鼠标移动在深入代码之前我们先要理解 Windows 系统判断“用户活跃”的机制。系统主要通过检测输入设备键盘、鼠标、触摸屏等的活动来判定用户是否在操作电脑。如果一段时间内没有任何输入事件系统就会触发一系列省电策略比如关闭显示器、进入睡眠或者启动屏幕保护程序并锁定。因此要“欺骗”系统保持活跃最直接的方法就是模拟产生这些输入事件。相比于模拟键盘按键可能会意外触发某些快捷键模拟鼠标移动是一种更安全、侵入性更低的方式。mouse-crawler选择了让鼠标指针在屏幕上做匀速直线运动并反弹这种模式计算简单视觉效果直观你可以看到指针在动且几乎不会对系统其他操作造成干扰。2.2 技术栈选型C 与原生 Windows API项目选择 C 和原生 Windows API 来实现这是一个非常经典且高效的选择主要基于以下几点考量极致的轻量与高效作为一个后台常驻的小工具它需要占用尽可能少的系统资源。C 编译出的原生可执行文件无需像 Python 或 .NET 程序那样依赖庞大的运行时环境内存占用极低执行效率极高。对 Windows 系统的深度集成要实现模拟鼠标移动和监听用户输入需要直接调用 Windows 底层的 API。C 与 Windows API 是天作之合可以方便地调用user32.dll中的函数如SetCursorPos设置光标位置和GetAsyncKeyState获取按键状态实现精准控制。跨编译器支持项目通过 CMake 进行构建管理明确支持 MSVCVisual Studio 的编译器和 MinGWGCC 的 Windows 端口。这使得无论是使用 Visual Studio 的开发者还是喜欢 GCC 工具链的开发者都能轻松地编译这个项目提升了项目的可访问性。注意正因为其依赖原生 Windows API所以这个程序是仅限 Windows 平台的。无法直接在 Linux 或 macOS 上运行。如果需要在其他平台实现类似功能需要调用对应系统的图形接口如 X11 或 Quartz。2.3 程序运行模式无控制台窗口项目特性中提到“Runs without a console (executable)”。这指的是程序编译后可以被配置为WinMain入口点的 GUI 子系统程序而不是main入口点的控制台子系统程序。这样运行起来就不会弹出一个黑色的命令行窗口更像一个默默工作的后台服务用户体验更好。在实现上这通常通过在 CMake 中链接Windows子系统或者在源代码中指定链接器选项来实现。不过查看该项目的源码会发现它目前仍然是一个控制台程序有main函数。作者所说的“executable”可能更侧重于指它是一个独立的、双击即可运行的.exe文件无需安装。如果要真正隐藏控制台窗口则需要额外的代码如FreeConsole()API或编译设置。3. 关键代码解析与实操要点让我们来拆解一下实现这个“弹跳鼠标”功能的核心代码逻辑。虽然原项目仓库的代码可能不长但其中涉及的几个关键点值得深入探讨。3.1 获取屏幕边界鼠标要在屏幕内移动首先要知道“舞台”有多大。这需要获取屏幕的分辨率。#include windows.h int screenWidth GetSystemMetrics(SM_CXSCREEN); int screenHeight GetSystemMetrics(SM_CYSCREEN);这里使用GetSystemMetricsAPI传入SM_CXSCREEN和SM_CYSCREEN参数分别获取主显示器的宽度和高度以像素为单位。这是最常用的方法。需要注意的是对于多显示器系统这个 API 获取的是虚拟屏幕的尺寸或者主显示器的尺寸取决于系统设置。如果希望程序在多个显示器组成的虚拟桌面内弹跳就需要使用GetMonitorInfo等更复杂的多显示器 API 来获取所有显示器的联合区域。3.2 模拟鼠标移动让鼠标“自己动”的核心是SetCursorPos函数。BOOL SetCursorPos(int X, int Y);这个函数将光标位置设置到指定的屏幕坐标。坐标原点(0, 0)在屏幕的左上角X轴向右递增Y轴向下递增。我们需要在一个循环中不断计算下一个位置并调用这个函数。弹跳的逻辑就是经典的物理学“碰壁反弹”。我们需要为鼠标指针定义一个移动速度向量(dx, dy)。每一帧或每次循环新的位置(x, y)等于旧位置加上速度向量x dx; y dy;。当x即将小于0左边界或大于screenWidth右边界时将dx取反dx -dx。同理当y碰到上下边界时将dy取反。这样就能实现持续的弹跳运动。3.3 检测用户活动并退出程序不能一直霸占鼠标必须能在用户回来时立刻退出。这通过两个检测来实现检测真实鼠标移动在每次我们自己通过SetCursorPos移动鼠标后立刻记录下这个位置。然后在下一轮循环开始前再次获取当前鼠标位置使用GetCursorPos。如果这两个位置不相等说明在这之间发生了非程序控制的鼠标移动即用户移动了鼠标此时程序应退出。检测键盘或鼠标按键使用GetAsyncKeyState函数。这个函数可以检查某个虚拟键码在当前时刻的状态。我们可以循环检查所有常用键如VK_LBUTTON,VK_RBUTTON,VK_SPACE,VK_ESCAPE等甚至使用VK_0到VK_9、VK_A到VK_Z来检查字母数字键。一旦检测到有任何键被按下程序也立即退出。// 示例检测ESC键是否被按下 if (GetAsyncKeyState(VK_ESCAPE) 0x8000) { // 用户按下了ESC退出循环 break; } // 也可以循环检查一个键码范围 for (int i 0; i 256; i) { if (GetAsyncKeyState(i) 0x8000) { // 有任何键被按下退出 break; } }实操心得在检测用户鼠标移动时有一个常见的“坑”。由于我们程序自己也在用SetCursorPos移动鼠标这个操作本身可能会被系统视为一个“鼠标移动事件”。如果处理不当程序可能会误判为用户活动而立即退出。因此必须在逻辑上严格区分“程序移动”和“用户移动”。上面提到的“记录-对比”法是一个有效策略只有在非程序移动周期内发生了位置变化才判定为用户活动。3.4 主循环与延时控制程序的主体是一个while循环。在每次循环中依次执行计算新位置、移动鼠标、检测退出条件。如果不加控制这个循环会以CPU所能达到的最高速度运行导致鼠标指针疯狂闪烁移动并且占用大量CPU资源。因此必须在每次循环末尾加入一个短暂的延时例如使用Sleep()函数。#include windows.h // ... while (true) { // 1. 计算下一个鼠标位置 (x, y) // 2. 调用 SetCursorPos(x, y) // 3. 检测用户活动如果满足条件则 break // 4. 延时控制移动速度 Sleep(10); // 休眠10毫秒 }Sleep(10)意味着每秒大约执行100次循环100 FPS。这个速度下鼠标移动看起来会比较平滑。你可以调整这个值Sleep(50)会更慢更省电Sleep(5)会更快但更耗资源。根据你的需求找到一个平衡点。4. 从零构建与编译指南原项目给出了基于 CMake 的构建命令这里我们展开说明并补充一些实际编译中可能遇到的细节。4.1 环境准备安装编译工具链方案一使用 Visual Studio (MSVC)这是最省心的方式。直接安装 Visual Studio 2022 或更高版本在安装时务必勾选“使用 C 的桌面开发”工作负载。它会自动安装 MSVC 编译器、CMake 和 Windows SDK。安装完成后你可以在开始菜单找到“Developer Command Prompt for VS 2022”这是一个已经配置好编译环境变量的命令行终端。方案二使用 MinGW-w64如果你更喜欢 GCC 系列编译器可以下载 MinGW-w64。推荐从 MSYS2 安装它提供了优秀的包管理器。安装 MSYS2。打开 MSYS2 UCRT64 或 MINGW64 终端。安装必要的包pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-make。安装后你可以在该终端内使用g、cmake等命令。4.2 获取项目源码与编译步骤假设你已经安装了上述任一环境并且cmake和编译器cl或g命令已在终端路径中。获取代码你可以直接下载项目的 ZIP 包或者使用 Git 克隆如果项目托管在 GitHub 上。git clone https://github.com/DasKaroWow/mouse-crawler.git cd mouse-crawler创建构建目录并生成构建系统这是 CMake 的标准“out-of-source build”做法保持源码目录清洁。mkdir build cd build接下来根据你的编译器生成对应的工程文件。对于 MSVC你可以直接运行cmake ..CMake 会自动检测到 Visual Studio 的编译器并生成.sln解决方案文件。如果你想生成 Release 版本可以指定cmake .. -DCMAKE_BUILD_TYPERelease对于 MinGW你需要指定生成器为MinGW Makefilescmake .. -G MinGW Makefiles -DCMAKE_BUILD_TYPERelease执行编译对于 MSVC (生成了 .sln)你可以用cmake --build . --config Release命令编译也可以直接用 Visual Studio 打开build目录下的.sln文件进行编译。对于 MinGW (生成了 Makefile)直接运行cmake --build . --config Release或者简单的make命令即可。编译成功后你会在build/Release/或build/目录下找到mouse-crawler.exe或类似名称的可执行文件。4.3 进阶修改为无控制台窗口程序如果你希望编译出的程序运行时完全不显示黑框控制台窗口需要对源代码或 CMake 配置进行小修改。方法一修改 CMakeLists.txt在项目的CMakeLists.txt文件中找到定义可执行目标 (add_executable) 的地方之后添加链接器选项。add_executable(mouse-crawler WIN32 ${SOURCE_FILES})将WIN32关键字放在可执行目标名后面这会告诉 CMake 这是一个 GUI 子系统程序。或者也可以在之后设置属性add_executable(mouse-crawler ${SOURCE_FILES}) set_target_properties(mouse-crawler PROPERTIES WIN32_EXECUTABLE TRUE)方法二修改源代码将main函数改为WinMain这是 Windows GUI 程序的入口点。你需要包含windows.h并且函数签名如下int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) { // 你原来的main函数代码放在这里 return 0; }改为WinMain后程序默认就没有控制台了。但注意printf之类的标准输出将无处可去调试信息可能需要用OutputDebugString或写入日志文件。注意事项改为无控制台程序后启动和终止变得不那么直观。你只能通过任务管理器来结束它。因此保留一个控制台窗口或者提供一个简单的退出机制如检测到特定按键组合对于用户体验会更好。原项目可能正是出于简单和易于调试的考虑保留了控制台。5. 使用场景、变体与扩展思路5.1 核心使用场景防系统休眠/锁屏这是最主要的功能。在进行长时间渲染、下载、数据传输时启动此程序可以确保系统不会因无操作而进入睡眠或锁屏中断任务。演示或测试在需要保持屏幕常亮进行演示或者测试某些与用户空闲状态相关的软件功能时可以用它来模拟用户持续在场。简单的自动化测试虽然功能单一但可以作为学习 GUI 自动化测试的一个起点理解如何用代码控制光标。5.2 潜在问题与排查程序无法结束如果程序逻辑有缺陷可能导致检测用户活动的代码失效程序无法退出。此时可以按Ctrl Alt Delete打开任务管理器在“详细信息”或“进程”选项卡中找到mouse-crawler.exe右键结束任务。鼠标移动卡顿或不流畅可能是主循环中的Sleep时间设置过长或者计算位置、检测按键的代码效率太低。尝试减少Sleep时间并确保不要在循环内进行复杂的计算或IO操作。在多显示器上行为异常如前所述简单的GetSystemMetrics只针对主显示器。如果你的鼠标跳到了另一个显示器上“消失”了或者反弹边界不对就需要升级代码以支持多显示器。可以使用EnumDisplayMonitorsAPI 枚举所有显示器并计算出一个包含所有显示器的虚拟边界矩形。被杀毒软件误报模拟鼠标和键盘输入是许多恶意软件的行为因此这类工具可能会被敏感的杀毒软件标记为“风险工具”或“潜在不受欢迎的程序”。如果遇到此情况你需要将编译出的可执行文件添加到杀毒软件的信任区白名单中。5.3 功能扩展与变体想法这个项目结构清晰是进行功能扩展的绝佳模板。以下是一些可以尝试的方向可配置化速度与轨迹通过命令行参数或配置文件让用户可以设置鼠标移动的速度dx, dy的大小、反弹角度不仅仅是90度垂直反弹可以引入角度变化、甚至运动轨迹如圆形、Lissajous 曲线。触发与退出允许用户自定义退出热键如Ctrl Shift Q而不是任意键。增强用户体验系统托盘图标将程序改为后台服务在系统托盘显示一个图标。右键图标可以暂停、恢复、退出程序或者打开配置界面。这需要处理 Windows 窗口消息循环和托盘图标 API (Shell_NotifyIcon)。暂停/恢复功能检测到用户活动时不是立即退出而是暂停模拟。当用户再次空闲一段时间例如30秒后自动恢复模拟。这需要结合计时器和状态机。技术深化跨平台版本使用跨平台 GUI 库如 Qt 或 wxWidgets 重写使其能在 Linux 和 macOS 上运行。在 Linux 上可能需要使用 X11 或 Wayland 的客户端库来模拟鼠标事件。注入式模拟当前的SetCursorPos是全局的但有些应用程序尤其是全屏游戏或安全软件会屏蔽它。可以学习使用更底层的SendInputAPI它能合成更真实的输入事件流穿透性更强。这个小小的mouse-crawler项目就像一把钥匙打开了一扇通往 Windows 桌面自动化与系统编程的大门。从理解屏幕坐标、模拟输入到处理多线程、用户界面每一步都充满了实践和学习的乐趣。