如何在Windows 2012及更早系统的Go终端应用中处理箭头键？

核心原理：用原生控制台输入记录替代虚拟终端模式 #

Windows Server 2012及之前的系统不支持ENABLE_VIRTUAL_TERMINAL_INPUT，只能通过系统原生的INPUT_RECORD输入记录机制直接读取底层按键事件，这是操作系统层面的基础API，无需第三方库或VS工具链依赖。

具体实现步骤 #

1. 获取标准输入句柄 #

通过Windows API GetStdHandle获取控制台输入句柄，这是读取原始按键的前提：

import (
    "syscall"
    "unsafe"
)

var stdinHandle syscall.Handle

func init() {
    var err error
    stdinHandle, err = syscall.GetStdHandle(syscall.STD_INPUT_HANDLE)
    if err != nil {
        panic(err)
    }
}

2. 禁用快速编辑模式 #

默认控制台的快速编辑模式会拦截箭头键等特殊按键，必须先关闭该模式：

const (
    ENABLE_QUICK_EDIT_MODE = 0x0040
    ENABLE_INSERT_MODE     = 0x0020
)

func disableQuickEdit() error {
    var mode uint32
    if err := syscall.GetConsoleMode(stdinHandle, &mode); err != nil {
        return err
    }
    // 清除快速编辑和插入模式标记
    mode &^= ENABLE_QUICK_EDIT_MODE | ENABLE_INSERT_MODE
    return syscall.SetConsoleMode(stdinHandle, mode)
}

3. 读取原始按键事件 #

调用ReadConsoleInput直接读取控制台的INPUT_RECORD，从中提取按键事件：

const (
    KEY_EVENT_RECORD = 0x0001
    VK_UP            = 0x26
    VK_DOWN          = 0x28
    VK_LEFT          = 0x25
    VK_RIGHT         = 0x27
)

type INPUT_RECORD struct {
    EventType uint16
    Event     [24]byte // 对应C语言联合体，用字节数组存储
}

type KEY_EVENT_RECORD struct {
    KeyDown         int32
    RepeatCount     uint16
    VirtualKeyCode  uint16
    VirtualScanCode uint16
    UnicodeChar     uint16
    ControlKeyState uint32
}

func readKeyEvents() ([]KEY_EVENT_RECORD, error) {
    var records [10]INPUT_RECORD
    var numRead uint32
    err := syscall.ReadConsoleInput(stdinHandle, &records[0], uint32(len(records)), &numRead)
    if err != nil {
        return nil, err
    }

    var keyEvents []KEY_EVENT_RECORD
    for i := 0; i < int(numRead); i++ {
        if records[i].EventType == KEY_EVENT_RECORD {
            var keyEvent KEY_EVENT_RECORD
            // 内存拷贝转换联合体
            copy((*(*[24]byte)(unsafe.Pointer(&keyEvent)))[:], records[i].Event[:])
            if keyEvent.KeyDown != 0 { // 只处理按下事件
                keyEvents = append(keyEvents, keyEvent)
            }
        }
    }
    return keyEvents, nil
}

4. 转换箭头键为ANSI控制序列 #

捕获到箭头键的虚拟键码后，将其转换为标准终端控制序列，再通过远程连接传递：

func translateKeyToAnsi(keyEvent KEY_EVENT_RECORD) []byte {
    switch keyEvent.VirtualKeyCode {
    case VK_UP:
        return []byte("\x1b[A")
    case VK_DOWN:
        return []byte("\x1b[B")
    case VK_LEFT:
        return []byte("\x1b[D")
    case VK_RIGHT:
        return []byte("\x1b[C")
    default:
        // 普通字符直接返回Unicode编码
        return []byte(string(rune(keyEvent.UnicodeChar)))
    }
}

关键注意点 #

• 程序启动时必须调用disableQuickEdit()，否则箭头键会被控制台拦截。
• ReadConsoleInput是阻塞调用，建议在goroutine中处理，避免阻塞主逻辑。
• 所有实现均基于Go标准库的syscall和unsafe包，完全依赖Windows原生API，无第三方依赖。

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