GetKeyState()检测按键后如何清除控制台输入的残留字符

问题背景 #

开发控制台登录系统时，设计逻辑为用户按下1键后进入用户名创建流程，但实际运行时，用于触发流程的1按键字符会残留在控制台输入缓冲区中，被后续的用户名输入逻辑直接读取，导致输入异常。

复现代码 #

#include <Windows.h>
#include <iostream>
#include <string>

bool pressed1;
std::string inputUsername;

do
{
    pressed1 = GetKeyState('1') & 0x8000;
    if (pressed1) {
        std::cout << "\nPressed '1' enter username: ";
        std::cin >> inputUsername;
    }
} while (!pressed1);

异常表现 #

按下1键后，控制台会自动在输入位填充残留的1字符，输出如下：

Pressed '1' enter username: 1

问题原因 #

GetKeyState是Windows提供的键盘物理状态检测API，仅负责查询指定按键的实时按下状态，不会消费控制台输入缓冲区中已写入的按键字符。用户按下1时，字符已经被写入标准输入流对应的缓冲区，后续直接调用std::cin读取内容时，会优先读取到缓冲区中残留的1字符。

修复方案 #

在检测到1键按下、正式读取用户名之前，先清空标准输入流的全部残留内容，同时增加按键释放等待逻辑，避免长按按键导致的重复触发。

1. 补充需要的头文件：<limits>（用于获取输入流最大长度）
2. 检测到按键按下后，先等待按键释放
3. 重置输入流状态，清空缓冲区所有残留字符后再读取用户名

修正后的完整代码：

#include <Windows.h>
#include <iostream>
#include <string>
#include <limits>

int main()
{
    bool pressed1;
    std::string inputUsername;
    
    do
    {
        pressed1 = GetKeyState('1') & 0x8000;
        if (pressed1) {
            // 等待1键释放，避免长按重复触发
            while (GetKeyState('1') & 0x8000) {
                Sleep(10);
            }
            // 重置输入流状态，清空缓冲区所有残留字符直到换行符
            std::cin.clear();
            std::cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n');
            
            std::cout << "\nPressed '1' enter username: ";
            std::cin >> inputUsername;
            // 后续可继续编写用户名校验等逻辑
        }
    } while (!pressed1);

    return 0;
}

关键逻辑说明 #

• std::cin.clear()：重置标准输入流的状态标记，避免流处于错误状态时后续操作失效
• std::cin.ignore(参数1, 参数2)：从输入流中提取并丢弃字符，直到丢弃字符数达到参数1指定的最大值，或是遇到参数2指定的分隔符（这里是换行符\n）为止，可彻底清空缓冲区中残留的触发按键、冗余输入内容。

内容的提问来源于stack exchange，提问作者ToastY