termui仅支持终端环境，需在main()开头调用Init()且避免重定向；组件须调SetRect()设置尺寸；事件循环须处理ResizeEvent并手动Render；TabPane切换需手动刷新界面。
termui 不能直接用于 Web 或 GUI 场景，它只在终端（TTY）中工作；初始化失败最常见原因是没调用 termui.Init() 或程序被重定向了 stdout/stderr（比如管道或日志文件）。
termui.Init() 失败的典型表现和修复
运行后立即 panic 报错 "termbox: error initializing termbox"，或黑屏无输出、卡死、退出无声——基本都是初始化环节出问题。
- 确保在
main()开头就调用termui.Init()，且仅调用一次；延迟或条件化调用会导致不可预测行为 - 不要把程序输出重定向：例如
go run main.go | cat、go run main.go > out.log会破坏 termbox 的底层终端控制，必须直接在真实终端中运行 - Windows 用户注意：某些 PowerShell 版本或 VS Code 集成终端默认不启用虚拟终端支持，可尝试改用 Windows Terminal，或在 PS 中执行
$host.UI.RawUI.EnableVirtualTerminalProcessing = $true - Linux/macOS 下若用 tmux/screen，请确认 TERM 环境变量正确（如
export TERM=xterm-256color），否则termui.Init()可能静默失败
组件渲染前必须设置 SetRect()
所有 widgets（如 widgets.NewParagraph()、widgets.NewGauge()）创建后是“无尺寸”的，不调用 SetRect(x, y, w, h) 就调 termui.Render()，界面会空白或崩溃。
-
SetRect()参数单位是字符格（cell），不是像素；(0, 0, 20, 5)表示从左上角开始，宽 20 字符、高 5 行 - 坐标系原点在左上角，Y 向下增长；超出终端实际大小时，termui 会自动裁剪，但内容可能被截断
- 多个组件共用区域会导致覆盖——没有 Z-order，后
Render()的组件会盖住前面的；需手动规划布局或用grid管理
事件循环里别漏掉 KeyboardEvent 和 ResizeEvent
termui.PollEvents() 返回的 channel 会持续发送事件，但如果你只处理 KeyboardEvent，窗口缩放时界面不会自适应，Ctrl+C 也可能无法退出。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 必须显式检查
e.Type == termui.ResizeEvent，然后重新调用各组件的SetRect()并termui.Render()，否则布局僵化 - 退出逻辑不能只依赖
"<c-c>"</c-c>；不同终端对组合键识别不一致，建议同时监听"q"、"Q"和"<c-c>"</c-c> - 不要在事件循环里做耗时操作（如 HTTP 请求、文件读写），会阻塞 UI 响应；需用 goroutine + channel 解耦
TabPane 切换内容时容易忽略的刷新陷阱
widgets.NewTabPane() 自身不持有子组件，只是个导航器；切换标签页时，你得自己决定“该渲染谁”，但很多人忘了清屏或覆盖旧内容。
- 每次
ActiveTabIndex变化后，必须手动调用termui.Render()渲染对应组件；仅改索引不会自动刷新画面 - 如果两个 tab 共用同一块屏幕区域，前一个组件的残留内容可能未被擦除——建议在
Render()前先用termui.Clear()或统一用grid分区管理 -
TabPane不自动响应内容变化；比如某个 tab 里的Gauge.Value更新了，必须再次termui.Render()才可见，不能靠绑定机制
termui 的核心约束很朴素：它不抽象终端能力，而是直译终端语义。这意味着你得时刻记得——它没有“重绘脏区域”“事件委托”或“状态绑定”，所有渲染、尺寸、交互都由你线性控制。最容易出问题的，永远是忘记某处该调 Render()，或误以为某个行为是自动发生的。
