gocui初始化失败主因是main goroutine退出过快：必须在gui.mainloop()前创建至少一个尺寸合法的视图、设置焦点、绑定按键，否则mainloop立即返回导致进程终止。
gocui 初始化失败：main goroutine 退出太快
直接在 main() 里调用 gocui.NewGui() 然后立刻 gui.MainLoop()，程序常一闪而退或 panic：「fatal error: all goroutines are asleep」。根本原因是 gocui 启动后依赖事件循环维持运行，但若没提前注册视图、按键绑定或没处理好 goroutine 生命周期，MainLoop() 可能立即返回，main 协程随之结束。
- 必须在
gui.MainLoop()前完成至少一个视图的创建（gui.SetView()）和布局设置 - 哪怕只是空视图，也要确保它存在且尺寸合法（宽高 ≥1），否则
gocui内部会跳过渲染并提前退出 - 不要在
main()中直接写逻辑——把初始化逻辑包进函数（如run()），用defer gui.Close()放在最前，再调用gui.MainLoop()
视图内容不刷新：忘记调用 view.Write() 或 view.Clear()
写入字符串后界面没变化，不是 UI 卡住，而是 gocui 不自动刷新——所有输出都需显式写入视图缓冲区，且刷新由主循环统一触发。常见误操作是用 fmt.Fprint(view, "...") 但没清空旧内容，导致文字堆叠、换行错乱。
- 每次更新前建议先
view.Clear()，避免残留 - 写入后无需手动刷新，
gui.MainLoop()每帧会自动同步所有视图缓冲区到终端 - 若需实时响应（比如日志流），别在长循环里反复
Write()——应通过gui.Update(func(g *gocui.Gui) error { ... })安全更新，避免并发写视图 panic
按键绑定无效：handler 返回值或绑定时机不对
注册了 gui.SetKeybinding(..., gocui.KeyEnter, gocui.ModNone, handler)，但按回车没反应。可能原因有三：视图未获得焦点、handler 函数签名错误、或绑定发生在 gui.MainLoop() 之后。
- handler 必须是
func(*gocui.Gui, *gocui.View) error类型，返回非 nil error 会中断主循环（调试时可临时 return nil） - 绑定必须在
gui.MainLoop()调用前完成；若想动态绑定，要用gui.SetKeybinding()并指定目标视图名（第二个参数） - 默认所有视图无焦点，需显式调用
gui.SetCurrentView("view-name")，否则按键事件不会路由到该视图绑定
Windows 下中文显示异常或光标错位
在 Windows Terminal 或 CMD 中运行，中文显示为方块、输入框光标偏移、甚至 panic 报「invalid rune」。这不是 gocui 的 bug，而是 Windows 控制台默认编码（GBK）与 Go 字符串（UTF-8）不匹配，且部分终端不支持 ANSI 光标定位序列。
- 强制启用 UTF-8：启动前执行
chcp 65001（仅 CMD），或优先使用 Windows Terminal / WSL - 避免在视图中混用全角/半角空格做对齐——
gocui按 rune 计数，中文占 2 列，空格占 1 列，错位由此而来 - 禁用光标闪烁（某些终端不兼容）：在初始化后加
gui.Cursor = false
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
