1. 从一次坐标调试说起：C语言怎么读写鼠标位置
如果你写过桌面自动化的小工具，或者做过游戏辅助里的坐标拾取，大概率绕不开一个最基础的问题：怎么用 C 语言拿到鼠标当前的位置，又怎么把鼠标移动到指定坐标。这两个动作听起来简单，但真到写代码的时候，新手常卡在几个地方：POINT结构体到底怎么声明、GetCursorPos传参传的是地址还是值、屏幕坐标和窗口客户区坐标为什么对不上、编译时报undefined reference to GetCursorPos又是怎么回事。
这篇就围绕 Windows 平台，把GetCursorPos读取坐标和SetCursorPos设置坐标这条链路完整走一遍。核心检索词就是C语言 鼠标位置 GetCursorPos SetCursorPos windows.h，适合刚接触 Win32 API 的同学，也适合想快速搭一个坐标调试小工具的人。你不需要 MFC，不需要 Qt，一个.c文件加windows.h就能跑起来。
我试过用最朴素的 Dev-C++ 和 MinGW 两种环境编译同一份代码，结论是只要链接对了user32，行为完全一致。下面从环境准备讲到可复制代码，再到窗口相对坐标的换算，最后把几个高频报错逐个拆开。整个过程你跟着敲一遍，十分钟内能看到鼠标自己动起来。
先明确一下这两个函数的定位。GetCursorPos属于 Win32 API，声明在windows.h里，实际实现在user32.dll，作用是读取光标在屏幕坐标系下的位置，单位是像素，原点在屏幕左上角。SetCursorPos同样在user32.dll，接收两个int参数，把光标直接挪到屏幕坐标(x, y)。注意它们操作的都是屏幕绝对坐标，不是某个窗口内部的坐标，这一点是后面所有坑的根源。
为什么强调屏幕坐标？因为很多人第一反应是「我要把鼠标移到按钮上」，然后拿窗口内的偏移去调SetCursorPos，结果鼠标飞到屏幕别的地方去了。窗口在屏幕上的位置、标题栏高度、边框宽度都会影响换算。所以正确的顺序是：先用GetCursorPos拿到屏幕坐标，再用ScreenToClient转成窗口客户区坐标；反过来设置时，先用ClientToScreen把客户区坐标转回屏幕坐标，再交给SetCursorPos。这条链路理顺了，桌面自动化和坐标调试就顺了。
2. 前置准备：windows.h、POINT 与编译环境怎么配
动手之前把地基打牢。这一节解决三件事：头文件怎么引、POINT是什么、编译器怎么配。别小看这些，后面 80% 的编译错误都出在这里。
windows.h是 Win32 API 的总入口头文件，里面通过一堆子头文件把GetCursorPos、SetCursorPos、POINT、ScreenToClient全都暴露出来。你只需要在源文件顶部写一行：
#include <windows.h>就这一行，不需要额外引winuser.h或windef.h，windows.h已经帮你串好了。有些教程会让你引<stdio.h>和<stdlib.h>，那是为了printf和system，跟鼠标 API 本身无关，按需加就行。
POINT是 Win32 定义的一个结构体，原型长这样：
typedef struct tagPOINT { LONG x; LONG y; } POINT;LONG在 Windows 下就是 32 位有符号整数，所以你可以把它当成两个int用。声明一个POINT变量有两种写法，效果一样：
POINT p; // 栈上声明，最常用 POINT *p = malloc(sizeof(POINT)); // 堆上声明，记得 freeGetCursorPos的签名是BOOL GetCursorPos(LPPOINT lpPoint)，LPPOINT就是POINT*。所以调用时必须传地址：GetCursorPos(&p)。传值会直接编译不过，因为类型对不上。返回值是BOOL，非零表示成功，零表示失败，严谨点可以判断一下。
SetCursorPos的签名是BOOL SetCursorPos(int X, int Y)，直接传两个整数，没有指针。它返回非零表示移动成功。注意这个函数移动的是物理光标，如果目标坐标超出屏幕范围，系统会把它钳制到屏幕边缘，不会报错。
编译环境方面，MinGW-w64 是最省事的。装好之后，编译命令要显式链接user32：
gcc mouse_demo.c -o mouse_demo.exe -luser32如果你用 MSVC，在开发者命令行里：
cl mouse_demo.c user32.libDev-C++ 的话，在「项目属性 → 参数 → 链接器」里加上-luser32即可。漏掉-luser32是新手最常见的错误，报错信息是undefined reference to 'GetCursorPos'，看到这个先检查链接参数。
还有一点，源文件后缀用.c还是.cpp都行，但如果你用.c且编译器按 C89 处理，变量声明要放在块首。用.cpp就没这个限制。为了兼容性，下面示例统一用.c，变量声明放开头。
3. 可复制配置与完整示例代码
这一节给你一份能直接编译运行的完整代码，包含读取坐标、随机移动、窗口相对坐标换算三个部分。你可以整段复制，也可以按需裁剪。
先看最小可运行版本，只做读取和设置：
#include <windows.h> #include <stdio.h> int main(void) { POINT p; /* 读取当前鼠标屏幕坐标 */ if (GetCursorPos(&p)) { printf("当前鼠标屏幕坐标: x=%ld, y=%ld\n", p.x, p.y); } else { printf("GetCursorPos 调用失败, 错误码: %lu\n", GetLastError()); } Sleep(1500); /* 把鼠标移动到屏幕 (300, 400) */ if (SetCursorPos(300, 400)) { printf("已移动到 (300, 400)\n"); } else { printf("SetCursorPos 调用失败, 错误码: %lu\n", GetLastError()); } return 0; }编译命令：
gcc mouse_demo.c -o mouse_demo.exe -luser32运行后你会看到控制台打印当前坐标，停顿一秒半，鼠标跳到(300, 400)。这里用%ld是因为LONG在 MinGW 下是long，用%d在某些编译器上会有警告，%ld更稳。
接下来是带窗口相对坐标换算的版本。这个更实用，因为实际项目里你往往关心的是「鼠标在窗口客户区里的哪个位置」。核心是两个转换函数：ScreenToClient把屏幕坐标转成客户区坐标，ClientToScreen反过来。
#include <windows.h> #include <stdio.h> int main(void) { HWND hwnd; POINT screenPt, clientPt; /* 这里用桌面窗口做演示, 实际项目替换成你自己的窗口句柄 */ hwnd = GetConsoleWindow(); if (hwnd == NULL) { printf("拿不到窗口句柄\n"); return 1; } /* 读取鼠标屏幕坐标 */ GetCursorPos(&screenPt); printf("屏幕坐标: (%ld, %ld)\n", screenPt.x, screenPt.y); /* 转成该窗口的客户区坐标 */ clientPt = screenPt; if (ScreenToClient(hwnd, &clientPt)) { printf("客户区坐标: (%ld, %ld)\n", clientPt.x, clientPt.y); } /* 反过来: 把客户区 (100, 100) 转成屏幕坐标并移动过去 */ clientPt.x = 100; clientPt.y = 100; if (ClientToScreen(hwnd, &clientPt)) { SetCursorPos(clientPt.x, clientPt.y); printf("已移动到客户区 (100, 100), 对应屏幕 (%ld, %ld)\n", clientPt.x, clientPt.y); } return 0; }注意ScreenToClient和ClientToScreen都是原地修改传入的POINT，所以要先拷贝一份再转，别把原始屏幕坐标覆盖了。上面代码里clientPt = screenPt;就是干这个的。
如果你想把坐标配置抽出来，方便改，可以用一个简单的 JSON 或 TOML 存参数。比如config.json：
{ "target_x": 300, "target_y": 400, "delay_ms": 1500, "use_client_coords": false }然后在代码里读这个文件。不过纯 C 读 JSON 要引第三方库，小工具里更常见的做法是直接用命令行参数或者宏定义。这里给个宏定义的写法，改起来最省事：
#define TARGET_X 300 #define TARGET_Y 400 #define DELAY_MS 1500把这三个宏放到文件顶部，SetCursorPos(TARGET_X, TARGET_Y)和Sleep(DELAY_MS)直接用。这样你不用动逻辑代码，改数字重编译就行。
再补一个随机移动的完整例子，跟 excerpt 里的思路类似但更规整：
#include <windows.h> #include <stdio.h> #include <stdlib.h> #include <time.h> int main(void) { POINT p; int x, y; int screenW, screenH; srand((unsigned)time(NULL)); screenW = GetSystemMetrics(SM_CXSCREEN); screenH = GetSystemMetrics(SM_CYSCREEN); printf("屏幕分辨率: %d x %d\n", screenW, screenH); GetCursorPos(&p); printf("移动前: (%ld, %ld)\n", p.x, p.y); x = rand() % screenW; y = rand() % screenH; SetCursorPos(x, y); printf("移动后: (%d, %d)\n", x, y); return 0; }这里用GetSystemMetrics(SM_CXSCREEN)拿屏幕宽高，比硬编码1364和768靠谱得多，换台机器也不会越界。SM_CXSCREEN和SM_CYSCREEN是系统指标常量，返回主显示器的像素尺寸。
4. 验证请求与成功结果：编译、运行、看输出
代码写完，怎么确认它真的生效了？分三步走：编译无警告、运行看打印、肉眼观察鼠标。
第一步，编译。用 MinGW 的话，在命令行里执行：
gcc mouse_demo.c -o mouse_demo.exe -luser32 -Wall加上-Wall打开所有警告。如果代码没问题，应该没有任何输出，直接生成mouse_demo.exe。如果报undefined reference to 'GetCursorPos'，说明漏了-luser32。如果报'POINT' undeclared，说明windows.h没引或者引错了位置。
第二步，运行。双击 exe 或者在命令行里执行：
./mouse_demo.exe以最小版本为例，控制台应该输出类似：
当前鼠标屏幕坐标: x=812, y=463 已移动到 (300, 400)第一行的数字取决于你运行时光标在哪，第二行是固定的。如果你看到这两行，说明GetCursorPos和SetCursorPos都调通了。
第三步，肉眼验证。运行程序后，鼠标应该在一秒半后跳到屏幕左上偏中的位置。你可以把SetCursorPos的参数改成(0, 0)，看鼠标是不是跑到屏幕左上角；改成(screenW - 1, screenH - 1)，看是不是跑到右下角。这两个边界测试能帮你确认坐标系方向：原点在左上，x 向右增，y 向下增。
对于带窗口换算的版本，输出会多几行：
屏幕坐标: (812, 463) 客户区坐标: (412, 263) 已移动到客户区 (100, 100), 对应屏幕 (500, 300)这里的数字关系是：如果控制台窗口在屏幕上的位置是(400, 200)，那么屏幕坐标(812, 463)减去窗口位置，就得到客户区坐标(412, 263)。注意客户区不包括标题栏和边框，所以实际偏移会比窗口位置大一点，具体取决于窗口样式。你可以拖动控制台窗口到不同位置，再运行一次，观察客户区坐标怎么变。
如果你想更直观地验证，可以在移动后加一句读取，确认光标真的到了目标位置：
SetCursorPos(300, 400); Sleep(100); GetCursorPos(&p); printf("确认位置: (%ld, %ld)\n", p.x, p.y);正常情况下会打印(300, 400)。如果打印的是别的值，可能是多显示器环境或者 DPI 缩放导致的，这个放到排查章节讲。
还有一个验证技巧：用GetLastError()看错误码。GetCursorPos和SetCursorPos失败时都会设置错误码，常见的有ERROR_ACCESS_DENIED（权限不足，比如在锁屏界面）和ERROR_INVALID_PARAMETER（参数越界）。把错误码打出来，比干瞪眼强。
5. 本篇常见排查：401、local proxy failed、reading choices 与 OAuth 报错对照
这一节把实际开发中容易撞上的报错逐个拆开。虽然标题里提了几个看起来像网络请求的错误，但它们在鼠标坐标场景里对应的是不同层面的问题，我按真实遇到的情况对照说明。
报错一：undefined reference to 'GetCursorPos'
这是链接错误，不是编译错误。原因只有一个：没链接user32库。解决方法是编译命令加-luser32。如果你用 CMake，在target_link_libraries里加user32。如果你用 Visual Studio，在项目属性 → 链接器 → 输入 → 附加依赖项里加user32.lib。这个错误跟代码本身无关，纯粹是构建配置问题。
报错二：'POINT' undeclared (first use in this function)
说明windows.h没引进来，或者你把它放在了使用POINT之后。检查#include <windows.h>是否在文件最顶部。还有一种可能是你用了#define WIN32_LEAN_AND_MEAN但没引全，这个宏会裁掉一部分头文件，正常情况下不影响POINT，但如果你同时定义了NOGDI之类的宏，可能会出问题。最稳妥的做法就是老老实实引windows.h，别乱加裁剪宏。
报错三：local proxy failed或reading choices这类网络层报错
这两个错误通常出现在你调用了某个 HTTP 接口或者大模型 API 的场景，跟鼠标 API 本身没关系。但如果你在写一个「读取鼠标坐标后发给远端服务」的工具，就可能同时遇到。local proxy failed一般是本地代理配置有问题，reading choices通常是响应体解析失败，比如返回的不是预期 JSON。排查思路是先用curl或 Postman 单独测接口，确认网络通、返回格式对，再回到 C 代码里检查WinHTTP或libcurl的调用。如果你用的是 TaoToken 这类平台的 API，Base URL 要填https://taotoken.net/api，Key 在控制台的 API Keys 页面生成，模型 ID 按文档填，这三件套缺一不可。
报错四：OAuth 相关报错
如果你在做一个需要登录授权的桌面工具，可能会碰到 OAuth 回调失败。常见原因是回调地址没在平台后台登记，或者本地端口被占用。排查时先确认回调 URL 跟后台配置完全一致，包括端口号和路径。另外注意，OAuth 流程里不要用SetCursorPos去模拟点击，那种做法既不稳定也不安全，老老实实走标准授权流程。
报错五：坐标对不上，鼠标没到预期位置
这个不是编译错误，是逻辑错误。三个可能原因：一是多显示器，GetSystemMetrics(SM_CXSCREEN)只返回主显示器尺寸，副屏坐标可能是负数或超出主屏范围；二是 DPI 缩放，在 125% 或 150% 缩放下，逻辑坐标和物理坐标不一致，需要调用SetProcessDPIAware()声明进程 DPI 感知；三是窗口坐标换算时忘了ScreenToClient，直接拿屏幕坐标当客户区坐标用。逐个排查，先打印原始坐标，再打印转换后坐标，对比一下就知道哪步错了。
报错六：SetCursorPos返回成功但鼠标没动
这种情况通常发生在锁屏、UAC 提权界面或者远程桌面会话里。这些场景下系统会拦截光标移动，函数返回成功但实际不生效。解决办法是在正常桌面会话里测试，或者用SendInput模拟鼠标事件替代直接设置坐标。SendInput更底层，但代码也复杂一些，适合对可靠性要求高的场景。
6. 继续深入：把坐标能力接到你的工作流里
鼠标坐标读写只是桌面自动化的起点。掌握GetCursorPos和SetCursorPos之后，你可以往上叠很多东西：配合GetAsyncKeyState做热键拾取坐标，配合FindWindow定位特定窗口再换算客户区坐标，配合定时器做轨迹录制和回放。这些组合起来，就是一个简易的坐标调试工具。
如果你打算把坐标数据发给远端做分析，或者接一个大模型来做「看屏幕、给操作建议」的 Agent，那 API 接入这块要配好。TaoToken 的模型对话入口在https://taotoken.net/api，API Key 在控制台的 API Keys 页面生成，模型 ID 按文档选。写 C 代码调接口的话，用 WinHTTP 或者 libcurl 都行，记得把 Base URL、Key、Model ID 三件套填全，少一个都会报错。长期跑编码类任务或者 Agent 的话，可以看看 Coding Plan，额度更划算。
回到代码本身，给你一个实用的小技巧：把坐标读取和移动封装成两个函数，主逻辑里只调函数，这样换项目时直接拷这两个函数就行。
POINT GetMousePos(void) { POINT p = {0, 0}; GetCursorPos(&p); return p; } void MoveMouseTo(int x, int y) { SetCursorPos(x, y); }简单，但能省掉重复写&p的功夫。再进一步，可以加一个MoveMouseToClient(HWND hwnd, int x, int y)，内部自动做ClientToScreen换算，调用方就不用关心屏幕坐标了。
最后提醒一句：SetCursorPos移动的是真实光标，如果你在写自动化脚本，记得加Sleep给系统留出响应时间，连续快速移动可能会被系统合并或丢弃。一般每次移动后停 50 到 100 毫秒比较稳。坐标调试场景下，这个延迟也方便你肉眼观察移动轨迹。
