构建轻量级 CLI 交互式选项选择器：仅控制当前行的光标与高亮-Golang-PHP中文网

构建轻量级 CLI 交互式选项选择器：仅控制当前行的光标与高亮

本文介绍如何在 go 中实现不依赖全屏渲染、仅操作当前终端行的箭头键导航菜单，通过底层终端控制技术实现在单行内高亮切换选项，兼顾简洁性与响应性。

本文介绍如何在 go 中实现不依赖全屏渲染、仅操作当前终端行的箭头键导航菜单，通过底层终端控制技术实现在单行内高亮切换选项，兼顾简洁性与响应性。

在命令行应用中实现“行内”（inline）交互式选项选择——即不进入全屏模式、仅在当前光标所在行动态高亮并切换选项——是提升用户体验的关键技巧。这避免了 tcell 或 termbox 常见的全屏缓冲区管理开销，更适合轻量 CLI 工具（如快速配置选择器、简易表单或上下文敏感快捷菜单）。

核心思路是：绕过高级 TUI 库的屏幕抽象层，直接读取原始终端输入事件，并结合 ANSI 转义序列动态重绘当前行。Go 标准库本身不提供跨平台键盘事件监听，但可通过以下方式实现：

✅ 推荐方案：使用 golang.org/x/term + syscall（Unix）或 golang.org/x/sys/windows（Windows）组合
自 Go 1.23 起，x/term 提供了 MakeRaw() 和 ReadPassword() 等底层能力；配合手动解析 ANSI 键码（如 ↑ 为 \x1b[A，→ 为 \x1b[C），即可实现无依赖的单行导航：

package main

import (
    "fmt"
    "os"
    "runtime"
    "strings"
    "syscall"
    "unsafe"

    "golang.org/x/term"
)

func main() {
    fd := int(os.Stdin.Fd())
    oldState, err := term.MakeRaw(fd)
    if err != nil {
        panic(err)
    }
    defer term.Restore(fd, oldState)

    options := []string{"Install", "Update", "Uninstall", "Quit"}
    selected := 0

    // 初始渲染（单行）
    renderLine(options, selected)

    buf := make([]byte, 4) // 最长 ANSI 序列（如 \x1b[123A）不超过 4 字节
    for {
        n, _ := os.Stdin.Read(buf[:])
        if n == 0 { continue }

        switch string(buf[:n]) {
        case "\x1b[A": // ↑
            selected = (selected - 1 + len(options)) % len(options)
            renderLine(options, selected)
        case "\x1b[B": // ↓
            selected = (selected + 1) % len(options)
            renderLine(options, selected)
        case "\x1b[C": // →
            selected = (selected + 1) % len(options)
            renderLine(options, selected)
        case "\x1b[D": // ←
            selected = (selected - 1 + len(options)) % len(options)
            renderLine(options, selected)
        case "\r", "\n": // Enter
            fmt.Printf("\n→ Selected: %s\n", options[selected])
            return
        case "\x03": // Ctrl+C
            fmt.Println("\nInterrupted.")
            return
        }
    }
}

func renderLine(opts []string, sel int) {
    // 清除当前行并回退到行首（ANSI: \r\x1b[K）
    fmt.Print("\r\x1b[K")
    for i, opt := range opts {
        if i > 0 {
            fmt.Print(" | ")
        }
        if i == sel {
            fmt.Printf("\x1b[7m%s\x1b[0m", opt) // 反色高亮
        } else {
            fmt.Print(opt)
        }
    }
    fmt.Print("\r") // 光标归位，准备下次覆盖
}

⚠️ 注意事项：

此方案需调用 term.MakeRaw() 关闭终端回显与行缓冲，否则无法捕获方向键；
Windows 上需额外处理 syscall.Syscall 调用（x/sys/windows 提供 ReadConsoleInput）；
避免使用 fmt.Scanln 等阻塞式输入——它们无法解析转义序列；
若需更健壮的跨平台支持（如处理 Home/End/PgUp 键），建议封装 gdamore/tcell 的 tcell.NewScreen() 并设置 tcell.ScreenOptions{DisableEvents: true}，再手动监听单行区域——虽非纯“无屏”，但可禁用全屏刷新，仅重绘局部。