gocui 初始化失败主因是未设置活跃view或未注册view，必须调用SetView后显式SetCurrentView，MainLoop需在主线程阻塞运行，避免goroutine并发调用，并注意Windows兼容性及CI环境tty检查。
gocui 初始化失败：无法启动主循环
直接调用 gui.MainLoop() 会卡住或 panic，常见原因是没提前设置好 root view 或没注册任何 view。gocui 要求至少有一个 view 处于 active 状态才能进入事件循环。
- 必须在
gui.SetView()后显式调用gui.SetCurrentView()，否则MainLoop()启动即退出 - 避免在 goroutine 中异步调用
MainLoop()—— 它本身是阻塞的，且内部依赖主线程的 stdin/stdout 控制权 - 初始化时加
gui.SetInputMode(gocui.InputEsc | gocui.InputEnter | gocui.InputArrow)，否则键盘事件（如方向键）默认不触发
goroutine 与 gocui 生命周期冲突：服务启停时 panic
Go 服务通常长期运行并监听信号，而 gocui 的 MainLoop() 是同步阻塞的，若强行用 go gui.MainLoop()，会导致 view 渲染错乱、panic: runtime error: invalid memory address（因底层 termbox state 被并发修改）。
- 正确做法：把 gocui 当作服务的主入口，即整个服务以终端 UI 为驱动，HTTP/gRPC server 启动为后台 goroutine
- 用
gui.Close()配合os.Interrupt信号捕获，但注意Close()不是幂等的，重复调用会 panic，建议用 sync.Once 包裹 - 不要在 view 回调里直接启动新 goroutine 去更新 view —— 所有 view 修改必须通过
gui.Update()或在主线程上下文中进行
实时刷新 view 内容：避免闪烁和光标错位
频繁调用 view.Clear() + view.Write() 会导致终端闪烁、滚动位置丢失，尤其当 view 高度动态变化时。
- 优先使用
view.Replace([]byte{...})替代逐行Write()，它能原子替换内容并保持光标位置 - 若需格式化输出（如表格），先构建完整字符串再一次性
Replace，避免多次WriteString引发重绘抖动 - 对高频更新场景（如每秒刷新指标），用
time.AfterFunc()节流，并在回调中检查gui.IsRunning()，防止关闭后仍尝试更新已销毁的 view
跨平台兼容性：Windows 下 termbox 初始化失败
Windows 默认控制台不兼容 termbox（gocui 底层依赖），运行时可能报错 panic: failed to open /dev/tty 或直接黑屏无响应。
立即学习“go语言免费学习笔记（深入）”；
- 必须启用 Windows ANSI 支持：程序启动时执行
syscall.SetConsoleMode(syscall.Stdin, 0x00020000|0x00000020)（需要 import "syscall"） - 推荐改用
github.com/marcusolsson/tui-go或github.com/charmbracelet/bubbletea替代 —— 它们对 Windows 更友好，但 gocui 本身在 Windows 上需额外 patch - CI/CD 环境（如 GitHub Actions）无 tty，
gocui会立即 panic，上线前务必用if !isTerminal() { log.Fatal("not a terminal") }检查
