1. 为什么鼠标移动比鼠标点击更难写对做 Windows 自动化脚本时鼠标点击几乎是第一个被跑通的动作调一次mouse_event左右键按下抬起事件就发出去了。但鼠标移动经常是第二个坑——很多人写完发现光标纹丝不动或者动了但目标程序没反应或者一动就把屏保计时重置了却不知道原因。核心检索词就三个SetCursorPos、mouse_event、MOUSEEVENTF_MOVE。前者是直接设置光标坐标后者是往系统输入队列里注入一个相对位移事件两者语义完全不同混用就会出问题。这篇面向的是自动化脚本与测试场景你要在 Windows 上让光标从 A 点走到 B 点再在 B 点完成一次点击并且希望这套骨架能直接复制进自己的工程里跑。适合谁写过一点 C#/C/Python ctypes、知道 Win32 API 大概长什么样、但被“移动不生效”卡住的人。我会先给一份可复制的配置骨架再带你分两步验证先只跑坐标定位确认光标真的到了再叠加点击事件确认目标窗口收到了输入。最后把常见的失效原因逐条排掉。需要说明的是SetCursorPos和mouse_event(MOUSEEVENTF_MOVE, ...)有一个容易被忽略的差异前者是绝对定位直接把光标放到指定屏幕坐标后者是相对位移按 dx/dy 增量移动。很多游戏或带输入校验的程序只认其中一种所以骨架里我会把两条路径都留出来方便你切换验证。2. 前置准备TaoToken 与运行环境这套骨架本身不依赖任何在线服务纯 Win32 调用就能跑。但如果你后续要把鼠标自动化接到大模型驱动的 Agent 里——比如让模型决定“点哪个按钮”再由脚本执行移动和点击——那中间需要一个稳定的模型调用入口。我平时用 TaoToken 来做这一层官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是让你在脚本里用统一的接口调模型把“决策”和“执行”拆开鼠标动作这部分仍然由本地 Win32 完成不涉及任何输入注入的合规问题。环境上你需要Windows 10/11Visual Studio 或任意能编译 C# 的环境我用 .NET 6 控制台验证以及一个用来观察结果的记事本或画图窗口。如果你用 Pythonctypes直接调 user32.dll 也行骨架逻辑一致。先确认你的进程有权限向目标窗口发送输入——普通桌面程序一般没问题以管理员身份运行的程序需要你的脚本也提权否则输入会被 UIPI 拦掉这是后面排障的重点之一。3. 可复制配置骨架SetCursorPos 与 mouse_event 双路径下面这份 C# 骨架把两种移动方式和点击都封装好了直接复制就能编译。核心是三个 P/Invoke 声明和两个封装方法。using System; using System.Runtime.InteropServices; using System.Threading; class MouseSim { [DllImport(user32.dll)] static extern bool SetCursorPos(int x, int y); [DllImport(user32.dll)] static extern void mouse_event(uint dwFlags, int dx, int dy, uint dwData, UIntPtr dwExtraInfo); [DllImport(user32.dll)] static extern bool GetCursorPos(out POINT lpPoint); [StructLayout(LayoutKind.Sequential)] public struct POINT { public int X; public int Y; } const uint MOUSEEVENTF_MOVE 0x0001; const uint MOUSEEVENTF_LEFTDOWN 0x0002; const uint MOUSEEVENTF_LEFTUP 0x0004; const uint MOUSEEVENTF_ABSOLUTE 0x8000; // 路径一绝对定位直接设置光标坐标 static void MoveAbsolute(int x, int y) { SetCursorPos(x, y); } // 路径二相对位移按增量注入移动事件 static void MoveRelative(int dx, int dy) { mouse_event(MOUSEEVENTF_MOVE, dx, dy, 0, UIntPtr.Zero); } // 点击按下 抬起 static void LeftClick() { mouse_event(MOUSEEVENTF_LEFTDOWN, 0, 0, 0, UIntPtr.Zero); Thread.Sleep(30); mouse_event(MOUSEEVENTF_LEFTUP, 0, 0, 0, UIntPtr.Zero); } static void Main() { GetCursorPos(out POINT start); Console.WriteLine($起点: {start.X},{start.Y}); // 第一步只验证移动 MoveAbsolute(600, 400); Thread.Sleep(200); GetCursorPos(out POINT afterAbs); Console.WriteLine($SetCursorPos 后: {afterAbs.X},{afterAbs.Y}); MoveRelative(50, 0); Thread.Sleep(200); GetCursorPos(out POINT afterRel); Console.WriteLine($MOUSEEVENTF_MOVE 后: {afterRel.X},{afterRel.Y}); // 第二步验证点击 LeftClick(); Console.WriteLine(已发送左键点击); } }几个参数要点MOUSEEVENTF_MOVE的 dx/dy 是相对增量单位是像素正数向右/向下MOUSEEVENTF_ABSOLUTE如果和 MOVE 一起用dx/dy 会变成 0–65535 的归一化坐标那是另一套换算本篇骨架先不用避免混淆。dwData对鼠标事件恒为 0dwExtraInfo传UIntPtr.Zero即可。点击之间加 30ms 的Thread.Sleep是为了让按下和抬起分成两个独立事件太快有些程序会合并或漏掉。如果你用 Python等价写法是import ctypes, time u32 ctypes.windll.user32 u32.SetCursorPos(600, 400) time.sleep(0.2) u32.mouse_event(0x0001, 50, 0, 0, 0) # MOUSEEVENTF_MOVE time.sleep(0.2) u32.mouse_event(0x0002, 0, 0, 0, 0) # LEFTDOWN time.sleep(0.03) u32.mouse_event(0x0004, 0, 0, 0, 0) # LEFTUP4. 验证请求与成功结果分两步确认不要一上来就移动加点击一起跑那样出问题你分不清是移动没生效还是点击没生效。按下面的清单逐步来。第一步只跑MoveAbsolute(600, 400)。运行后立刻看屏幕光标应该瞬间跳到 (600,400)。同时程序打印的GetCursorPos结果应该和 600,400 一致。如果打印对了但光标没动说明你的进程和当前桌面不在同一个会话比如跑在服务里这是后面排障要处理的。第二步只跑MoveRelative(50, 0)。光标应该在当前位置基础上向右移 50 像素。注意这里有个细节如果你先做了绝对定位到 600,400再相对移动 50最终应该是 650,400。打印结果能对上就说明MOUSEEVENTF_MOVE生效了。第三步把光标停在记事本窗口的编辑区跑LeftClick()。记事本应该获得焦点光标在编辑区闪烁。如果点击没反应先确认记事本是不是被其他窗口挡住了或者你的脚本是不是以管理员运行而记事本不是——UIPI 会拦截低权限向高权限的输入反过来也一样。成功的结果是控制台依次打印起点、绝对定位后的坐标、相对移动后的坐标最后一行“已发送左键点击”同时记事本被激活。三步都过骨架就算跑通了。5. 本篇常见错排查光标完全不动但代码没报错。最常见的原因是进程会话隔离。如果你的脚本跑在 Windows 服务、计划任务未勾选“只在用户登录时运行”或某些 CI 环境里它处于 Session 0而你的桌面是 Session 1SetCursorPos作用在 Session 0 的虚拟桌面上你当然看不到。解决办法是确保脚本在交互式用户会话里运行。移动生效但目标程序不响应。有些程序尤其是游戏、带输入校验的客户端不读系统光标位置而是读原始输入设备事件。SetCursorPos只改光标位置不产生输入事件这类程序会认为“没有鼠标输入”。这时改用mouse_event(MOUSEEVENTF_MOVE, ...)注入相对位移它走的是输入队列能被这类程序感知。反过来有些程序只认绝对坐标那就用SetCursorPos。骨架里两条路径都留着就是为了这个。点击发出去了但点错位置。检查你是不是在移动后没等光标稳定就点击。SetCursorPos是同步的但某些程序处理移动有延迟加 100–200ms 的Thread.Sleep再点击会稳很多。另外确认你的坐标是屏幕坐标还是窗口客户区坐标SetCursorPos用的是屏幕坐标如果你从窗口句柄算出来的是客户区坐标需要先ClientToScreen转换。屏保或锁屏被意外触发。这就是SetCursorPos和MOUSEEVENTF_MOVE的差异所在mouse_event注入的移动事件会被系统当作真实输入能重置屏保计时和空闲检测而单纯SetCursorPos改坐标不一定被计入用户活动。如果你的场景需要“保持活跃”用MOUSEEVENTF_MOVE做微小位移比如 dx1比直接设坐标更合适。但要注意别在用户正在操作的桌面上乱动光标测试时找个空闲窗口。权限问题。目标程序以管理员运行你的脚本不是输入会被 UIPI 静默丢弃没有任何报错。把脚本也以管理员身份运行即可。反过来脚本是管理员而目标不是通常没问题但某些安全软件会拦截跨权限输入注入需要加白名单。6. 把鼠标骨架接进你的自动化流程跑通上面三步之后这套骨架就可以往两个方向扩展。一是加全局热键控制启停用RegisterHotKey注册一个组合键在消息循环里切换一个布尔标志决定是否执行移动和点击。二是托盘化用Shell_NotifyIcon把程序缩到托盘避免控制台窗口干扰测试。这两个都是标准 Win32 操作和鼠标 API 正交不影响骨架本身。如果你要把“点哪里”的决策交给模型可以在脚本里留一个函数把当前屏幕状态或目标描述发给模型拿回坐标或动作指令再调用MoveAbsolute/MoveRelative/LeftClick。模型调用这一层我用 TaoToken 的 API 接地址是 https://taotoken.net/api 密钥在控制台 https://taotoken.net/console 生成接入文档在 https://taotoken.net/doc 。这样决策和执行分离鼠标动作始终在本地完成调试时也容易定位是模型给错了坐标还是输入没生效。最后提醒一句自动化鼠标输入在测试自己的程序时很顺手但别拿去做违反目标软件服务条款的事。骨架给你的是能力用在哪由你判断。
