Windows用GetAsyncKeyState检测物理按键状态（最高位表示按下，低位表示击键），Linux/macOS需用termios设原始模式+read非阻塞读取，并处理ESC序列；跨平台须规避stdin缓冲差异与焦点问题。
Windows下用GetAsyncKeyState检测按键是否按下
Windows平台最直接的非阻塞键盘检测方式是调用WinAPI的GetAsyncKeyState，它不等待输入，只返回指定虚拟键当前是否被按下（或刚被按下）。注意：它检测的是物理按键状态，不是字符输入，也不受输入焦点限制（但需程序处于前台才能可靠响应）。
常见错误是误用GetKeyState——它返回的是线程消息队列里的键状态快照，对实时检测无效；而GetAsyncKeyState读取的是硬件层的即时状态。
- 参数传入虚拟键码，如
VK_LEFT、'A'（ASCII值可直接用）、VK_SPACE - 返回值为
short，最高位（bit 15）为1表示当前正被按下；最低位（bit 0）为1表示本次调用前刚被按下（即“击键事件”） - 需包含
- 频繁轮询时建议加
Sleep(1)避免CPU空转，但别用std::this_thread::sleep_for（可能精度不够）
// 检测方向键左键是否正在被按住
if (GetAsyncKeyState(VK_LEFT) & 0x8000) {
// 左键持续按下中
}
// 或检测一次性的按键动作（比如跳过动画）
if (GetAsyncKeyState('Z') & 1) {
// Z键刚被按下（哪怕只按了1ms）
}
Linux/macOS用termios关闭回车阻塞实现单字符读取
POSIX系统没有类似GetAsyncKeyState的API，常规std::cin.get()会阻塞直到用户敲回车。要实现“按一个键立刻响应”，必须切换终端为原始模式（raw mode），禁用行缓冲和回显。
核心是修改termios结构体的c_lflag字段：关掉ICANON（取消行缓冲）、ECHO（关闭回显），再用read(STDIN_FILENO, &c, 1)尝试读1字节——若无输入则立即返回-1（需提前设O_NONBLOCK）。
立即学习“C++免费学习笔记（深入）”；
- 务必在程序退出前恢复原终端设置，否则控制台会乱（比如输不了命令、看不到自己打的字）
- 不能用
std::cin混用，因为std::cin有自己的缓冲区，和底层read冲突 -
select()或poll()可用来判断是否有输入可读，避免忙等；但简单场景直接read+errno == EAGAIN也够用 - macOS上
termios行为与Linux基本一致，但某些终端模拟器（如iTerm2）可能有额外兼容性问题
跨平台封装要注意stdin缓冲与平台差异
想写一份代码在Windows/Linux/macOS都跑，不能只靠预编译宏切API——更关键的是理解各平台对stdin的处理逻辑不同：Windows控制台默认是行缓冲+回显，Linux终端默认是规范模式（canonical mode），而macOS的Terminal.app有时会把某些组合键（如Ctrl+方向键）发成多字节ESC序列。
- 不要依赖
std::cin.peek() != EOF判断是否有输入——它在规范模式下永远阻塞，直到回车 - Windows下即使用了
GetAsyncKeyState，也要注意cin缓冲区残留（比如之前用户输过字符串+回车，cin还没清完） - 如果同时需要读字符和检测功能键（F1~F12、方向键），Linux/macOS需解析ESC序列（如
\033[A是上箭头），而Windows直接用VK_UP即可 - 第三方库如
ncurses（Linux/macOS）或conio.h（Windows旧版）能简化，但引入依赖后就谈不上“轻量”了
容易忽略的细节：焦点、权限与组合键
非阻塞键盘检测实际落地时，最容易栽在看似无关的环境因素上。
- Windows下若程序窗口失去焦点（比如切到浏览器），
GetAsyncKeyState仍能读到按键，但部分安全策略或远程桌面会禁用该行为；Linux下终端未获得焦点时根本收不到输入 - Linux下普通用户无需特殊权限，但若用
ioctl(TIOCL_GETKMAP)之类底层调用，可能触发权限拒绝 - Ctrl/Ctrl+Shift/Alt+字母这类组合键，在
GetAsyncKeyState里要分别查VK_CONTROL和对应字母键；Linux下则要看终端是否把它们映射为独立序列（如Ctrl+C是\003，但Ctrl+T可能是\024或未定义） - 游戏类应用常需“连按”检测（如长按右键加速），这时不能只看单次返回值，得自己维护按键时间戳和状态机
真正难的从来不是“怎么读到一个键”，而是“怎么让这个键在各种终端、各种焦点状态、各种组合下，都稳定、低延迟、不干扰其他输入流”。
