1. 从大一那行SetCursorPos(0,0)说起：鼠标自动化到底难在哪
很多人第一次写 C++ 控制鼠标，都是从SetCursorPos(0,0)这一行开始的。看起来简单，但真正跑起来你会发现几个问题：光标确实动了，可点击没触发；或者点击触发了，但落点偏了几十像素；再或者程序编译过了，运行时却毫无反应。这些坑我在帮同学排查时几乎每周都能遇到。
这篇内容聚焦 Windows 平台下用 C++ 和windows.h实现鼠标定位与左键点击的完整流程，覆盖SetCursorPos、mouse_event、SendInput三种调用方式的差异，以及坐标换算、DPI 缩放、权限拦截等实际排障路径。适合刚接触 Win32 API 的 C++ 学习者、需要做桌面自动化的小工具开发者，以及想把鼠标控制接入到 AI 编码工作流里的同学。
后半部分我会给出一份可复制的config.toml骨架，把 TaoToken 的统一 Key 和 API 通道配置进去，这样你在写这类小工具时，可以顺手把模型调用、代码补全、Agent 任务串起来，不用每次手动切环境。整篇按「能编译、能跑、能看到光标落点、能排查报错」的标准来写，代码都可以直接拿走用。
2. 前置准备：TaoToken 统一 Key 与 API 通道配置
在写鼠标控制代码之前，先把开发环境里的模型调用通道配好。原因很实际：这类 Win32 小工具往往需要反复调试，如果每次都要手动改 Key、换 base_url，效率会很低。TaoToken 提供统一 Key 和统一 API 通道，把不同模型的调用收敛到一个入口，配置一次就能在多个工具里复用。
你需要先拿到 API Key。打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后在控制台里创建 Key。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，Key 管理页面在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。API 基础地址统一用 https://taotoken.net/api ，注意这个地址后面不加 UTM 参数，直接写进配置即可。
如果你只是想让模型帮你解释SendInput的参数含义，用模型对话页面就够了：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。如果你打算长期写这类 C++ 小工具，甚至让 Agent 帮你生成和修改代码，建议直接上 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，Claude Code 相关配置参考 https://taotoken.net/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
下面这份config.toml骨架可以直接复制，把your_api_key_here换成你控制台里的真实 Key：
# config.toml - TaoToken 统一通道配置骨架 # 用途：C++ 鼠标控制小工具开发时的模型调用配置 [provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key = "your_api_key_here" timeout_seconds = 60 [models] # 日常问答/代码解释 chat_model = "gpt-4o-mini" # 复杂代码生成/Agent 任务 coding_model = "claude-sonnet-4-20250514" [workspace] # 你的 C++ 工程目录 project_dir = "D:/cpp/mouse_click_demo" # 编译输出目录 build_dir = "D:/cpp/mouse_click_demo/build" [logging] level = "info" log_file = "D:/cpp/mouse_click_demo/taotoken.log"配置好之后，你在写SendInput那段代码时，遇到MOUSEINPUT结构体字段记不清，可以直接把问题丢给模型对话页面，让它结合你的代码上下文解释。这样比反复翻 MSDN 快很多。
3. 可复制配置：SetCursorPos 与 SendInput 的完整实现
3.1 头文件与链接库
Windows 下鼠标控制只需要一个头文件，但要注意链接顺序。windows.h必须放在最前面，否则会和iostream里的某些宏冲突：
#include <windows.h> #include <iostream> // 链接 user32.lib，SendInput 和 SetCursorPos 都在这个库里 #pragma comment(lib, "user32.lib") using namespace std;如果你用的是 MinGW 而不是 MSVC，#pragma comment不生效，需要在编译命令里手动加-luser32。
3.2 SetCursorPos 与 SendInput 的差异
SetCursorPos(x, y)只做一件事：把光标瞬间移动到屏幕坐标(x, y)。它不产生任何点击事件，也不会触发鼠标移动消息队列里的WM_MOUSEMOVE。很多同学以为移动完再调一次mouse_event就能点击，结果发现点击位置不对，原因就在这里。
mouse_event是旧版 API，虽然还能用，但微软官方已经建议用SendInput替代。SendInput的优势在于它把鼠标事件和键盘事件统一到一个结构体数组里，可以一次性提交多个事件，而且能更好地和系统输入队列同步。
下面这段代码实现了「移动到指定坐标 + 左键单击」的完整动作：
#include <windows.h> #include <iostream> using namespace std; // 将屏幕坐标转换为 SendInput 需要的绝对坐标（0-65535 归一化） void MoveAndClick(int x, int y) { // 获取屏幕分辨率 int screenWidth = GetSystemMetrics(SM_CXSCREEN); int screenHeight = GetSystemMetrics(SM_CYSCREEN); // 归一化坐标：SendInput 的绝对坐标范围是 0-65535 int normalizedX = (x * 65535) / (screenWidth - 1); int normalizedY = (y * 65535) / (screenHeight - 1); // 第一步：移动光标 INPUT moveInput = { 0 }; moveInput.type = INPUT_MOUSE; moveInput.mi.dwFlags = MOUSEEVENTF_MOVE | MOUSEEVENTF_ABSOLUTE; moveInput.mi.dx = normalizedX; moveInput.mi.dy = normalizedY; moveInput.mi.time = 0; moveInput.mi.dwExtraInfo = 0; SendInput(1, &moveInput, sizeof(INPUT)); // 给系统一点时间处理移动事件 Sleep(50); // 第二步：左键按下 + 抬起 INPUT clickInput[2] = { 0 }; clickInput[0].type = INPUT_MOUSE; clickInput[0].mi.dwFlags = MOUSEEVENTF_LEFTDOWN; clickInput[0].mi.time = 0; clickInput[0].mi.dwExtraInfo = 0; clickInput[1].type = INPUT_MOUSE; clickInput[1].mi.dwFlags = MOUSEEVENTF_LEFTUP; clickInput[1].mi.time = 0; clickInput[1].mi.dwExtraInfo = 0; SendInput(2, clickInput, sizeof(INPUT)); } int main() { cout << "3 秒后移动到 (500, 300) 并左键点击" << endl; Sleep(3000); MoveAndClick(500, 300); cout << "动作已发送，观察光标落点" << endl; return 0; }3.3 坐标换算的关键点
SendInput使用MOUSEEVENTF_ABSOLUTE时，坐标不是像素值，而是 0 到 65535 的归一化值。换算公式是：
normalizedX = (pixelX * 65535) / (screenWidth - 1) normalizedY = (pixelY * 65535) / (screenHeight - 1)如果你直接用像素值填进dx和dy，光标会跑到屏幕左上角附近，因为系统把 500 当成了归一化坐标里的 500，而不是第 500 个像素。
另外要注意 DPI 缩放。在 125% 或 150% 缩放的显示器上，GetSystemMetrics(SM_CXSCREEN)返回的是逻辑分辨率，而SendInput的绝对坐标基于物理分辨率。如果你的程序没有声明 DPI 感知，坐标会偏移。解决办法是在main函数开头加上：
SetProcessDPIAware();这行代码会让进程使用物理像素，GetSystemMetrics返回的值就和SendInput的坐标系一致了。
4. 验证请求：编译运行与成功结果观察
4.1 编译命令
用 MSVC 的话，在开发者命令提示符里执行：
cl /EHsc mouse_click.cpp /link user32.lib用 MinGW 的话：
g++ mouse_click.cpp -o mouse_click.exe -luser32编译过程中如果报undefined reference to SendInput，说明没链接user32.lib，检查上面的链接参数。
4.2 运行与观察
运行mouse_click.exe，你会看到控制台输出「3 秒后移动到 (500, 300) 并左键点击」。这 3 秒是留给你把鼠标移开的，避免程序移动光标时和你手动操作冲突。
3 秒后，光标应该瞬间跳到屏幕坐标(500, 300)的位置，然后触发一次左键单击。你可以提前打开一个画图软件或者文本编辑器，把窗口放在(500, 300)附近，观察点击是否落在预期位置。
如果光标移动了但没点击，检查SendInput的返回值。SendInput返回成功插入的事件数量，如果返回 0，说明事件被系统拦截了。可以在代码里加一行：
UINT result = SendInput(2, clickInput, sizeof(INPUT)); cout << "SendInput 返回: " << result << endl;正常情况下应该输出 2。如果输出 0，调用GetLastError()查看具体错误码。
4.3 用模型对话辅助验证
如果你不确定MOUSEEVENTF_ABSOLUTE和MOUSEEVENTF_MOVE的组合是否正确，可以把代码片段贴到模型对话页面 https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，让它逐行解释每个 flag 的作用。这比你自己翻文档快，而且能结合你的实际代码给出针对性建议。
5. 本篇常见错排查：光标不动、点击无效、坐标偏移
5.1 光标完全不动
最常见的原因是权限问题。如果你的程序没有管理员权限，而目标窗口是以管理员身份运行的，SendInput会被 UIPI（用户界面特权隔离）拦截。解决办法是用管理员身份运行你的程序，或者把目标窗口的权限降下来。
另一个原因是SendInput的cbSize参数传错了。必须是sizeof(INPUT)，不能是sizeof(MOUSEINPUT)。传错的话函数直接返回 0。
5.2 点击无效但光标移动了
检查MOUSEEVENTF_LEFTDOWN和MOUSEEVENTF_LEFTUP是否成对出现。只发 DOWN 不发 UP，系统会认为左键一直按着，后续点击都会变成拖拽。只发 UP 不发 DOWN，则什么都不会发生。
还有一个隐蔽的坑：SendInput的事件数组里，如果time字段填了非零值，系统会用它作为时间戳。填 0 表示使用系统当前时间。如果你手动填了一个过去的时间戳，事件可能被丢弃。
5.3 坐标偏移
前面提到的 DPI 缩放是主因。除了SetProcessDPIAware()，还可以在项目清单文件里声明 DPI 感知：
<dpiAware>true</dpiAware>如果你用的是多显示器，GetSystemMetrics(SM_CXSCREEN)只返回主显示器的分辨率。要获取虚拟屏幕的总尺寸，用SM_CXVIRTUALSCREEN和SM_CYVIRTUALSCREEN。跨屏移动时，坐标原点在主显示器的左上角，副屏在主屏右侧时 x 坐标为正值，在左侧时为负值。
5.4 编译报错MOUSEINPUT未定义
这个错误通常是因为windows.h被其他头文件污染了。确保#include <windows.h>是第一个包含的头文件。如果用了预编译头，检查pch.h里是否已经包含了windows.h。
5.5 程序运行后系统输入异常
如果你在调试时不小心让SendInput进入了死循环，鼠标会疯狂点击，这时候按 Ctrl+Alt+Del 可以中断。建议在代码里加一个Sleep(100)以上的间隔，避免事件发送过快导致系统输入队列堵塞。
6. 把鼠标控制接入 AI 编码工作流：Coding Plan 与接入文档
写这类 Win32 小工具，最耗时的往往不是核心逻辑，而是查 API 参数、处理编译错误、调试坐标偏移。如果你打算长期做桌面自动化，建议把 TaoToken 的 Coding Plan 用起来：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。它适合需要反复生成、修改、调试代码的场景，Agent 可以直接在你的工程目录里操作文件，省去手动复制粘贴的步骤。
接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有完整的 API 调用示例和配置说明。API Key 在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 管理，控制台在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。如果你用 Claude Code 做 C++ 开发，参考 https://taotoken.net/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 的配置方式。
回到鼠标控制本身，最后给你一个实用技巧：在MoveAndClick函数里加一个参数int delayMs，把移动和点击之间的Sleep(50)改成可配置的。有些窗口对输入事件的处理比较慢，50ms 不够，需要调到 100ms 甚至 200ms。这个值没有标准答案，取决于目标程序的响应速度，实测下来 100ms 能覆盖大多数场景。
