Dear ImGui 必须与底层渲染/事件系统配合使用，不能直接调用 ImGui::Render()；后端选择取决于现有图形栈，初始化顺序必须为窗口→渲染上下文→ImGui，且需正确绑定变量并处理 ini 文件写入权限。
Dear ImGui 本身不提供窗口管理或输入处理，必须和底层渲染/事件系统配合才能跑起来。直接链接 imgui.cpp 并调用 ImGui::Render() 是没用的——你会看到黑屏、无响应，或者崩溃。
怎么选对后端：别在 OpenGL/Vulkan/DX11 之间硬猜
选哪个后端，取决于你当前应用已有的图形栈。强行换渲染 API 不仅费时，还容易引入线程同步、资源生命周期等隐蔽问题。
- 已有 OpenGL 应用（比如用 GLFW + GLAD）→ 用
imgui_impl_glfw.cpp+imgui_impl_opengl3.cpp - 用 Vulkan 渲染 → 必须配
imgui_impl_vulkan.cpp和imgui_impl_glfw.cpp（或其他窗口后端），且要手动传VkInstance、VkDevice、VkQueue - 纯控制台或无图形需求的调试工具 → 可考虑
imgui_impl_sdl2.cpp+ SDL2 窗口，比 GLFW 更轻量
关键点：imgui_impl_*.cpp 文件不是可选插件，是强制依赖；漏掉任一实现，ImGui::NewFrame() 会卡死或断言失败。
初始化顺序不能错：窗口 → 渲染上下文 → ImGui
常见崩溃源于 ImGui::CreateContext() 被调得太早，比如在 OpenGL 上下文创建前就执行。ImGui 内部会尝试读取 GL 函数指针，此时为空，导致段错误。
立即学习“C++免费学习笔记（深入）”；
- 正确顺序：
glfwInit()→glfwCreateWindow()→glfwMakeContextCurrent()→gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)→ImGui::CreateContext()→ImGui_ImplGlfw_InitForOpenGL()→ImGui_ImplOpenGL3_Init() - 如果用 Vulkan，
ImGui_ImplVulkan_Init()必须在vkCreateDevice()之后、且传入有效的VkPipelineLayout - 忘记调
ImGui::StyleColorsDark()或ImGui::StyleColorsLight()不会崩溃，但控件默认是透明色，你会以为“界面没画出来”
调试窗口怎么加才不卡主线程？
ImGui 本身不阻塞，但如果你在 while (!done) { ImGui::NewFrame(); ... ImGui::Render(); } 循环里做了耗时计算（比如每帧 dump 10MB 内存），界面就会卡顿。这不是 ImGui 的问题，是你把调试逻辑写进了渲染循环。
- 把重操作移到单独线程或定时器中：比如用
std::chrono::steady_clock控制每 500ms 采样一次 CPU 占用，而不是每帧都查 - 用
ImGui::Begin() / ImGui::End()包裹的区域默认可拖拽、缩放、关闭；加ImGuiWindowFlags_NoSavedSettings可禁用自动保存位置尺寸（避免调试时反复读写imgui.ini） - 想显示实时日志？别用
ImGui::Text()逐行追加（性能差），改用ImGuiListClipper做虚拟滚动，或用ImGui::LogToClipboard()配合外部查看器
static bool show_debug_window = true;
if (show_debug_window) {
ImGui::Begin("Debug Info", &show_debug_window, ImGuiWindowFlags_AlwaysAutoResize);
ImGui::Text("FPS: %.1f", ImGui::GetIO().Framerate);
ImGui::Text("Allocated: %zu KB", memory_usage_kb);
if (ImGui::Button("Dump State")) {
dump_state_to_file(); // 这个函数别放在这里面做
}
ImGui::End();
}
为什么修改了值但程序没反应？检查变量绑定和作用域
ImGui 的控件（如 ImGui::SliderFloat()、ImGui::Checkbox()）只负责绘制和返回“本次是否被修改”，它不会自动更新你的业务逻辑变量——你得自己写响应代码。
- 错误写法：
float speed = 1.0f; ImGui::SliderFloat("Speed", &speed, 0.0f, 10.0f);—— 每帧都重置speed，滑块动了也白动 - 正确写法：把
speed提成成员变量或 static 局部变量，并在滑块返回 true 时才触发逻辑：if (ImGui::SliderFloat("Speed", &speed, 0.0f, 10.0f)) { apply_new_speed(speed); } - 多线程环境下读写同一变量？加锁不是唯一解——更安全的是用原子变量（
std::atomic）或双缓冲队列，避免 UI 线程卡住渲染线程
最容易被忽略的一点：imgui.ini 文件默认会生成在可执行文件同目录，如果程序以只读权限运行（比如 macOS 的 sandbox 或某些 Linux 容器），这个文件写入失败，会导致窗口位置、大小、折叠状态全部重置。要么显式禁用（ImGui::GetIO().IniFilename = nullptr;），要么确保路径可写。
