windows用getcursorpos获取屏幕坐标（左上原点），linux x11用xquerypointer查根窗口，macos用cgeventgetlocation创建虚拟事件提取（左下原点需转换）；三者均需检查失败并适配坐标系与权限模型。
Windows平台用GetCursorPos最直接
在Windows上，GetCursorPos是获取鼠标屏幕坐标的首选API，它返回的是相对于整个屏幕左上角的坐标（x, y），单位为像素。调用前需包含windows.h头文件。
常见错误是传入未初始化的POINT结构体指针却忽略返回值——该函数返回BOOL，失败时返回0，比如在无GUI会话（如服务进程）中会失败，但不报错也不提示。
- 必须检查返回值：
if (!GetCursorPos(&pt)) { /* 处理失败 */ } -
POINT结构体的x和y成员是LONG类型，不是int，跨平台移植时要注意符号与范围 - 该坐标系原点在屏幕左上角，y轴向下增长，符合Windows GDI约定
Linux下用X11的XQueryPointer需手动连接库
Linux桌面环境（X11）没有系统级“获取鼠标位置”的简单函数，得靠X11库的XQueryPointer。它需要一个有效的Display*和根窗口（通常是DefaultRootWindow(dpy)）才能工作。
容易踩的坑是忘记链接-lX11，或传入NULL作为display参数导致段错误；另一个问题是该函数返回的是相对于指定窗口的坐标，若要屏幕坐标，必须用根窗口查询。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 编译时加
-lX11，头文件为X11/Xlib.h - 调用前确保
XOpenDisplay(nullptr) != nullptr，Wayland环境下此调用会失败 - 返回的
*x_return和*y_return是相对于根窗口的坐标，即等效于屏幕坐标
macOS用CGEventGetLocation配合虚拟事件
macOS不提供直接读取鼠标位置的API，标准做法是创建一个空的虚拟鼠标移动事件，再从中提取位置——本质是“偷”当前状态。依赖CoreGraphics框架，需链接-framework CoreGraphics。
这个方法看似绕，但它是Apple官方推荐且稳定的方式。注意：它不触发权限弹窗，但若用户禁用了辅助功能权限（尤其macOS 10.15+），可能返回(0, 0)或无效值，且无法区分失败原因。
- 调用
CGEventCreate(nullptr)创建空事件，再用CGEventGetLocation提取CGPoint -
CGPoint的y轴向上增长（与屏幕坐标系相反），需转换：screenY = CGDisplayPixelsHigh(CGMainDisplayID()) - point.y - 该方式在App沙盒或无辅助权限时静默失效，建议加日志或fallback逻辑
跨平台封装要注意坐标系和权限差异
写一个统一接口时，不能只做条件编译，还得处理三端坐标系方向、失败语义、以及权限模型的根本不同：Windows默认允许，X11依赖DISPLAY环境变量和X server连接，macOS依赖辅助功能授权。
最容易被忽略的是macOS返回坐标原点在左下角，而Windows/X11都是左上角；还有就是Linux下Wayland已逐步取代X11，但XQueryPointer在Wayland会彻底失效，目前尚无标准替代方案（部分应用改用libinput监听设备节点，但需root权限）。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
