MapVirtualKey有一个known broken behaviour。

**2023年1月更新：**Microsoft docs was updated包含此行为。

The docs是骗你关于MAPVK_VK_TO_CHAR或2模式。
根据实验和leaked Windows XP source code（在\windows\core\ntuser\kernel\xlate.c文件中），它包含'A'..'Z' VKs的不同行为（这些VKs在Win32 API WinUser.h头中没有明确定义，相当于'A'..'Z' ASCII字符）：

case 2:

        /*
         * Bogus Win3.1 functionality: despite SDK documenation, return uppercase for
         * VK_A through VK_Z
         */
        if ((wCode >= (WORD)'A') && (wCode <= (WORD)'Z')) {
            return wCode;
        }

不知道为什么微软决定从Win 3. 1中删除这个错误，但我的Windows 10上的当前情况是这样的。
此外，some keyboard layouts可以在一次按键上发出多个WCHAR字符（UTF-16 surrogate pairs或可以包含多个Unicode代码点的连字）。MapVirtualKey与MAPVK_VK_TO_CHAR也无法为这些键返回正确的值-在这种情况下，它将返回U+F002代码点。
作为一种解决方法，我可以建议您使用ToUnicode[Ex] API，它可以为您完成此Map：

// Returns UTF-8 string
std::string GetStrFromKeyPress(uint16_t scanCode, bool isShift)
{
    static BYTE keyboardState[256];
    memset(keyboardState, 0, 256);

    if (isShift)
    {
        keyboardState[VK_SHIFT] |= 0x80;
    }

    wchar_t chars[5] = { 0 };
    const UINT vkCode = ::MapVirtualKeyW(scanCode, MAPVK_VSC_TO_VK_EX);
    // This call can produce multiple UTF-16 code points
    // in case of ligatures or non-BMP Unicode chars that have hi and low surrogate
    // See examples: https://kbdlayout.info/features/ligatures
    int code = ::ToUnicode(vkCode, scanCode, keyboardState, chars, 4, 0);

    if (code < 0)
    {
        // Dead key
        if (chars[0] == 0 || std::iswcntrl(chars[0])) {
            return {};
        }

        code = -code;
    }

    // Clear keyboard state
    {
        memset(keyboardState, 0, 256);

        const UINT clearVkCode = VK_DECIMAL;
        const UINT clearScanCode = ::MapVirtualKeyW(clearVkCode, MAPVK_VK_TO_VSC);
        wchar_t tmpChars[5] = { 0 };
        do {} while (::ToUnicode(clearVkCode, clearScanCode, keyboardState, tmpChars, 4, 0) < 0);
    }

    // Do not return control characters
    if (code <= 0 || (code == 1 && std::iswcntrl(chars[0]))) {
        return {};
    }

    return utf8::narrow(chars, code);
}

或者更好：如果您有Win32消息循环-只需使用TranslateMessage()（在后台调用ToUnicode()），然后处理WM_CHAR消息。
PS：这同样适用于GetKeyNameText API，因为它在键盘布局dll中没有显式名称设置的键的后台调用MapVirtualKey(vk, MAPVK_VK_TO_CHAR)（通常只有非字符才有名称）。