要读取控制台光标位置，必须先调用GetStdHandle(STD_OUTPUT_HANDLE)获取标准输出句柄，再将其传给GetConsoleScreenBufferInfo填充CONSOLE_SCREEN_BUFFER_INFO结构体，其中wCursorPosition字段（类型COORD）包含X（列号）、Y（行号）坐标。
GetStdHandle 和 GetConsoleScreenBufferInfo 怎么配合用
要读取控制台光标位置，必须先拿到标准输出句柄，再查缓冲区信息。GetStdHandle(STD_OUTPUT_HANDLE) 返回的句柄不能直接读坐标，得传给 GetConsoleScreenBufferInfo。这个函数会填充一个 CONSOLE_SCREEN_BUFFER_INFO 结构体，其中 wCursorPosition 字段才是真实坐标（类型是 COORD，含 X 和 Y）。
常见错误是忽略返回值检查：两个 API 都可能失败——比如重定向了 stdout（如管道或文件），GetStdHandle 就会返回 INVALID_HANDLE_VALUE；或者传入非法句柄，GetConsoleScreenBufferInfo 返回 FALSE。务必用 GetLastError() 辅助诊断。
-
COORD.X是列号（从 0 开始），COORD.Y是行号（不是像素，是字符单元） - 如果程序在 VS 的“输出”窗口运行，而非真正控制台，这两个 API 全部失效——返回默认或错误值
- 多线程下读取坐标本身是安全的，但若其他线程同时调用
SetConsoleCursorPosition，你读到的可能是瞬时旧值
SetConsoleCursorPosition 为什么设置后没反应
最常被忽略的是：该函数只影响「后续输出」的起始位置，不会移动已有文字，也不触发任何刷新。如果你调用后立刻 printf 或 std::cout，内容会出现在新位置；但如果没输出，光标“移动”就不可见。
另一个典型问题是坐标越界：SetConsoleCursorPosition 要求 COORD 的 X 必须小于当前缓冲区宽度（dwSize.X），Y 小于高度（dwSize.Y）。越界不会报错，但调用失败并返回 FALSE，且光标位置不变。
立即学习“C++免费学习笔记（深入）”；
- 缓冲区尺寸可通过
GetConsoleScreenBufferInfo的dwSize字段获取 - 控制台窗口大小可变，但缓冲区大小默认等于窗口大小；用
SetConsoleScreenBufferSize扩大缓冲区后，坐标上限随之提高 - 使用
std::cout （ANSI ESC 序列）也能清屏并归位，但这依赖终端支持，在 Windows 默认 cmd 中需启用ENABLE_VIRTUAL_TERMINAL_PROCESSING
ANSI 转义序列和 Windows API 混用要注意什么
Windows 10 1511+ 支持 ANSI，但默认不开启。直接发 3[H 这类序列，控制台会原样打印字符，而不是跳转光标。必须先调用 SetConsoleMode 启用 ENABLE_VIRTUAL_TERMINAL_PROCESSING 标志。
混用风险在于状态冲突：API 设置的光标位置和 ANSI 序列操作的是同一逻辑光标，但某些 ANSI 序列（如 \033[s 保存、\033[u 恢复）会绕过 API 管理，导致后续 API 调用读到的位置与实际不符。
- 启用 ANSI 的代码片段：
DWORD mode; GetConsoleMode(hOut, &mode); SetConsoleMode(hOut, mode | ENABLE_VIRTUAL_TERMINAL_PROCESSING); - API 更稳定、兼容性更好（XP 起全支持）；ANSI 更轻量，适合跨平台输出，但需额外初始化且易被中间层（如 IDE 控制台）拦截
- 不要在同一个程序里频繁切换——比如用 API 移动光标后，又用
\033[10;5H跳转，再调用GetConsoleScreenBufferInfo，结果可能滞后一帧
跨平台获取/设置光标位置有没有轻量方案
纯 C++ 标准库不提供光标控制，所有方案都依赖平台扩展。Linux/macOS 下一般用 ANSI（\033[6n 查询，\033[y;xH 设置），Windows 下优先用 API。真要写跨平台代码，建议封装一层：
#ifdef _WIN32
// 用 GetConsoleScreenBufferInfo / SetConsoleCursorPosition
#else
// 用 ioctl(TIOCGWINSZ) + printf("\033[6n") + parse response
#endif
注意：Linux 终端对查询光标坐标的响应（\033[y;xR）需要异步读取 stdin，容易阻塞；而 Windows API 是同步的。所以“查询-移动-再查询”的逻辑在 Linux 下更难做稳。
实际项目中，除非是终端 UI 工具（如 top、htop），否则多数场景只需单向设置（比如进度条覆盖上一行），这时连查询都可省略——直接用 \033[F（上一行）或 \033[K（清行）更简单可靠。
