imgui-go需每帧调用text/button因其基于即时模式gui，要求每帧完整重建ui结构与状态，框架不保存控件句柄，button返回值仅表示当帧点击事件，未调用即该控件当帧不存在。
Go 语言本身没有官方 GUI 库，imgui-go 是目前最成熟、可直接绑定 Dear ImGui C++ 后端的 Go 封装，但它不是“开箱即用”的控件库——它本质是即时模式（Immediate Mode）接口，所有 UI 都需每帧手动重建。这意味着你不能像写 button := NewButton("Click") 然后监听事件那样工作；UI 状态和逻辑必须显式管理。
为什么 imgui-go 的 Text / Button 每帧都得调用？
即时模式 GUI 的核心约定：每一帧（通常对应一次渲染循环）你都要完整描述当前 UI 的结构与状态。框架不保存控件句柄或生命周期，只根据你当帧传入的参数决定绘制什么、响应什么。比如 Button 返回 true 仅表示“这一帧被点击了”，下帧就失效；没被调用，就等于“这帧不存在这个按钮”。
- 不调用
Button→ 该按钮在本帧完全不可见、不可交互 - 把
Button放在if分支里 → 它只在条件为真时存在，且点击逻辑也只在该分支内生效 - 想让按钮保持“按下态”？得自己维护一个
bool变量，并传给Checkbox或用Button+ 手动状态切换
imgui-go 中窗口/布局崩溃或显示错位的常见原因
Dear ImGui 对调用顺序和嵌套层级非常敏感，Go 绑定继承了全部约束。最常踩的坑是：在未开始窗口（Begin）前调用控件，或在 End 后继续写 UI 代码。
- 必须成对使用
Begin/End：每个窗口块以imgui.Begin("MyWindow")开头，imgui.End()结尾；漏掉End会导致后续所有 UI 渲染错乱甚至 panic - 不能跨帧保留
Begin状态：不能在第 1 帧Begin，第 2 帧才End；必须单帧内闭合 -
SameLine必须紧跟前一个控件调用，中间插入Text或空行会破坏布局流 - 中文显示异常？大概率是没正确加载含中文字形的字体（
io.Fonts.AddFontFromFileTTF），且未调用io.Fonts.GetTexDataAsRGBA32更新纹理
如何安全地响应按钮点击并更新界面状态？
即时模式没有“事件注册”机制，响应 = 当帧检测到交互 + 手动变更状态 + 下帧用新状态重建 UI。典型模式是把 UI 控件和业务状态变量放在同一作用域，用闭包或结构体字段关联。
// 示例：带计数器的按钮
var counter int
for !window.ShouldClose() {
window.PollEvents()
window.BeginFrame()
imgui.Begin("Counter")
imgui.Text(fmt.Sprintf("Count: %d", counter))
if imgui.Button("Increment") {
counter++ // 点击发生在此帧，立即修改状态
}
imgui.End()
window.Render()
}
- 不要试图在
Button外部做“延迟响应”（如 goroutine sleep 后改状态）——下帧 UI 已重建，你的修改可能被覆盖或根本没触发重绘 - 复杂状态建议封装进 struct，方法内统一管理 UI 和数据，避免零散变量污染主循环
- 需要“长按”行为？得结合
IsItemActive和帧计时器，Button本身只返回单帧点击脉冲
真正难的不是写几个按钮，而是把整个应用逻辑适配成“每帧声明式重建”的思维——状态不能藏在控件背后，必须显式持有；UI 不是对象，只是函数调用序列。一旦习惯这种模式，你会发现它对调试、热重载、动态界面生成反而更直接。但切记：任何绕过 Begin/End、混用帧间状态、忽略字体/纹理初始化的尝试，都会在某个看似无关的改动后突然崩塌。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
