imgui::button返回true表示当帧发生完整点击，需直接用其返回值分支执行逻辑；同名按钮须加唯一id后缀；悬停/长按等需组合isitemhovered/isitemactive等api实现。
ImGui::Button 返回值就是点击事件
ImGui 的按钮本身不提供“回调函数”机制，ImGui::Button 调用后直接返回 true 当且仅当该帧发生了**一次鼠标按下并释放**（即完整点击），这是你绑定逻辑的唯一时机。别试图给它传 lambda 或注册事件监听——它根本不是那种 UI 库。
常见错误是写成这样：
ImGui::Button("Save"); // ❌ 只绘制，没接返回值，永远不响应
if (clicked) { ... } // clicked 未定义
正确做法是直接用返回值做分支：
if (ImGui::Button("Save")) { save_to_disk(); }- 按钮文本是 ID，若多次调用同名按钮（如循环中），必须加唯一标识，否则 ID 冲突导致点击失效：
ImGui::Button(("Delete##" + std::to_string(i)).c_str()) - 按钮宽度默认贴合文字，想固定宽高可用
ImGui::Button("Text", ImVec2(100, 0))（高度为 0 表示保持默认）
按钮状态不可靠？检查是否在无效区域或被遮挡
如果 ImGui::Button 始终返回 false，大概率不是代码问题，而是 ImGui 渲染上下文异常：
- 确保在
ImGui::Begin()/ImGui::End()之间调用，否则按钮不属任何窗口，输入事件无法路由 - 确认没有调用
ImGui::SetWindowFocus()后又忘了处理焦点丢失，或ImGui::CaptureKeyboardFromApp(true)拦截了输入 - 检查
ImGui::GetIO().WantCaptureMouse是否为true：若为false，说明 ImGui 没有获取到鼠标事件（可能是渲染线程/输入线程不同步，或 glfwSetInputMode 误关了捕获）
需要长按、悬停、禁用等状态？得自己扩展
原生 ImGui::Button 只暴露单次点击信号。要实现“按住持续触发”或“鼠标悬停变色”，需组合底层 API：
- 悬停检测：
if (ImGui::IsItemHovered()) { /* 高亮逻辑 */ } - 长按检测：
if (ImGui::IsItemActive() && ImGui::GetIO().DeltaTime > 0.05f) { /* 每帧触发，加计时器去抖 */ } - 禁用按钮：
ImGui::BeginDisabled(true); ImGui::Button("Grayed"); ImGui::EndDisabled(); - 注意：
ImGui::IsItemHovered()必须紧跟在ImGui::Button()后调用，中间不能插入其他控件，否则 item 指针已切换
多线程或异步操作中点击无响应？别在按钮回调里阻塞
ImGui 是单线程即时模式，所有 UI 逻辑必须在主线程的每帧内完成。如果你在 if (ImGui::Button(...)) 里做了耗时操作（如文件读写、网络请求），会导致整个 UI 卡死一帧甚至崩溃。
安全做法是只设标志位，由主循环或独立线程处理：
static bool g_save_requested = false;
if (ImGui::Button("Save")) g_save_requested = true;
<p>// 主循环 elsewhere:
if (g_save_requested) {
do_save_async(); // 启动异步任务
g_save_requested = false;
}
</p>
真正容易被忽略的是：ImGui 不管理业务状态生命周期。按钮点击只是个瞬时信号，后续所有状态同步、错误反馈、加载指示，都得你自己用变量+额外控件（如 ImGui::Text("Saving...")）补全。
