使用Windows Hooks拦截键盘事件实现类Vim编辑器的问题求助

核心问题分析 #

你的代码存在三个关键错误，导致模式切换失效、光标固定不动，以及程序无响应：

1. 缺少消息循环：WH_KEYBOARD_LL 类型的钩子依赖线程的消息循环才能触发回调。主线程未处理消息时，钩子回调永远不会执行，程序会陷入假死状态。
2. 按键检测逻辑错误：使用字符 'I' 匹配虚拟键码是错误的，应该用虚拟键码 VK_I；同时未区分按键消息类型（如按下/释放），会导致重复触发状态切换。
3. 控制台句柄重复获取：每次调用光标移动函数都重复调用 GetStdHandle，不仅效率低，还可能因句柄获取失败导致光标移动失效。

修正步骤与完整代码 #

1. 添加消息循环 #

在 main 函数中加入标准Windows消息循环，确保钩子回调能被触发：

MSG msg;
while (GetMessage(&msg, NULL, 0, 0) > 0) {
    TranslateMessage(&msg);
    DispatchMessage(&msg);
}
UnhookWindowsHookEx(hKeyboardHook);

2. 修正按键检测逻辑 #

在钩子回调中仅处理 WM_KEYDOWN 消息，使用正确的虚拟键码，并添加Shift状态判断（区分大小写的'i'）：

LRESULT CALLBACK KeyboardHookProc(int nCode, WPARAM wParam, LPARAM lParam) {
    if (nCode >= 0 && wParam == WM_KEYDOWN) { // 仅处理按键按下事件
        KBDLLHOOKSTRUCT* kbStruct = (KBDLLHOOKSTRUCT*)lParam;
        DWORD vkCode = kbStruct->vkCode;
        
        // 检测Escape键，切换到命令模式
        if (vkCode == VK_ESCAPE && editMode) {
            editMode = false;
            moveCursorToLastRow();
        }
        // 检测小写i键（无Shift），切换到编辑模式
        else if (vkCode == VK_I && !editMode && !(GetKeyState(VK_SHIFT) & 0x8000)) {
            editMode = true;
            moveCursorToFirstRow();
        }
    }
    return CallNextHookEx(NULL, nCode, wParam, lParam);
}

3. 缓存控制台句柄 #

在 main 函数中初始化全局的 hConsole 变量，避免重复获取：

hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
if (hConsole == INVALID_HANDLE_VALUE) {
    std::cerr << "Failed to get console handle\n";
    return 1;
}

完整修正代码 #

#include <windows.h>
#include <iostream>

HANDLE hConsole;
bool editMode = true;

void moveCursorToLastRow();
void moveCursorToFirstRow();

LRESULT CALLBACK KeyboardHookProc(int nCode, WPARAM wParam, LPARAM lParam) {
    if (nCode >= 0 && wParam == WM_KEYDOWN) {
        KBDLLHOOKSTRUCT* kbStruct = (KBDLLHOOKSTRUCT*)lParam;
        DWORD vkCode = kbStruct->vkCode;

        if (vkCode == VK_ESCAPE && editMode) {
            editMode = false;
            moveCursorToLastRow();
        }
        else if (vkCode == VK_I && !editMode && !(GetKeyState(VK_SHIFT) & 0x8000)) {
            editMode = true;
            moveCursorToFirstRow();
        }
    }
    return CallNextHookEx(NULL, nCode, wParam, lParam);
}

void moveCursorToFirstRow() {
    COORD cursorPosition = { 3, 2 };
    SetConsoleCursorPosition(hConsole, cursorPosition);
}

void moveCursorToLastRow() {
    CONSOLE_SCREEN_BUFFER_INFO csbi;
    if (!GetConsoleScreenBufferInfo(hConsole, &csbi)) {
        std::cerr << "Failed to get console info\n";
        return;
    }
    COORD cursorPosition = { 3, csbi.dwSize.Y - 1 };
    SetConsoleCursorPosition(hConsole, cursorPosition);
}

int main(int argc, char* argv[]) {
    hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
    if (hConsole == INVALID_HANDLE_VALUE) {
        std::cerr << "Failed to get console handle\n";
        return 1;
    }

    HINSTANCE hInstance = GetModuleHandle(NULL);
    HHOOK hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardHookProc, hInstance, 0);
    if (hKeyboardHook == NULL) {
        std::cerr << "Failed to install keyboard hook. Error: " << GetLastError() << "\n";
        return 1;
    }

    // 消息循环：必须保留，否则钩子回调无法触发
    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0) > 0) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    UnhookWindowsHookEx(hKeyboardHook);
    return 0;
}

替代方案（避免钩子） #

如果你不需要全局键盘监听，推荐使用 ReadConsoleInput 直接读取控制台输入，这种方式更轻量且无CPU占用问题：

// 在main函数中替换消息循环为输入监听循环
INPUT_RECORD inputRecord;
DWORD eventsRead;
while (true) {
    ReadConsoleInput(hConsole, &inputRecord, 1, &eventsRead);
    if (inputRecord.EventType == KEY_EVENT && inputRecord.Event.KeyEvent.bKeyDown) {
        WORD vkCode = inputRecord.Event.KeyEvent.wVirtualKeyCode;
        if (vkCode == VK_ESCAPE && editMode) {
            editMode = false;
            moveCursorToLastRow();
        }
        else if (vkCode == VK_I && !editMode && !(inputRecord.Event.KeyEvent.dwControlKeyState & SHIFT_PRESSED)) {
            editMode = true;
            moveCursorToFirstRow();
        }
    }
}

这种方式无需钩子，直接在主线程阻塞等待输入，CPU占用极低，更适合CLI程序场景。

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