核心是“不抢控制权”：imgui不创建窗口、不接管输入、不管理图形上下文，仅在已有渲染循环中插帧绘制ui；关键在三处——初始化时机（须在有效上下文make_current且glad/vulkan资源就绪后）、每帧输入同步（glfwpollevents→后端newframe→imgui::newframe）、渲染指令提交（imgui::render()后调用对应后端renderdrawdata并隔离状态）。
直接集成到已有渲染窗口，核心是“不抢控制权”——ImGui 不创建窗口、不接管输入、不管理 OpenGL/Vulkan 上下文，只在你已有的帧里画 UI。只要你的窗口能跑 OpenGL/Vulkan 渲染循环，就能加 ImGui，关键在三处：初始化时机、每帧输入同步、渲染指令提交位置。
必须先有有效的图形上下文，且在它之后初始化 ImGui
ImGui 本身不初始化 OpenGL 或 Vulkan，ImGui::CreateContext() 和后端 Init() 函数都依赖你已经创建好并 make_current 的上下文。常见错误是：在 GLFW 窗口创建后立刻调用 ImGui_ImplOpenGL3_Init()，但此时还没调用 glfwMakeContextCurrent(window) 或没成功加载 GL 函数指针。
- GLAD 用户：必须在
ImGui_ImplOpenGL3_Init()前完成gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)，否则所有 GL 调用为空指针 - Vulkan 用户：
ImGui_ImplVulkan_Init()需要传入VkInstance、VkDevice、VkQueue和对应的queue_family_index；这个 family 必须和你主渲染命令提交的 queue 完全一致，否则同步失败或断言崩溃 - 多窗口场景（如游戏+编辑器）：若共享 OpenGL 上下文，
ImGui_ImplOpenGL3_Init()只需在主上下文上调用一次；但每个窗口仍需独立调用ImGui_ImplGlfw_NewFrame()并传入对应GLFWwindow*
每帧顺序不能乱：后端 NewFrame → ImGui::NewFrame → 构建 UI → ImGui::Render()
顺序错一环，鼠标位置不准、按钮点不中、UI 不刷新。尤其注意两个后端 NewFrame() 的调用顺序：必须先 ImGui_ImplOpenGL3_NewFrame()（更新 DPI、上传字体纹理），再 ImGui_ImplGlfw_NewFrame()（读取鼠标/键盘状态），最后才是 ImGui::NewFrame()（开始构建 UI）。漏掉任意一个，ImGui::GetIO().MousePos 就是 (0, 0)，ImGui::IsItemHovered() 永远返回 false。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- GLFW 用户：确保
glfwPollEvents()在ImGui_ImplGlfw_NewFrame()之前被调用，否则输入状态不会更新 - 如果你手动处理输入（比如绕过 GLFW），必须自己把鼠标坐标、按键状态、滚轮值填进
ImGui::GetIO()对应字段，不能只调ImGui::NewFrame() -
ImGui::Render()后拿到的ImGui::GetDrawData()是只读数据，别缓存跨帧使用；下一帧调用ImGui::NewFrame()后它就可能被覆盖
渲染指令必须在你自己的绘制流程中“插队”，且状态要隔离
ImGui_ImplOpenGL3_RenderDrawData() 不是自动渲染，它只是把顶点和纹理喂给当前 OpenGL 上下文。如果它执行时你的 shader 还在绑定、VAO 还在启用、blend mode 还是 GL_ONE/GL_ZERO，UI 就会黑屏或花屏。
- OpenGL 下：必须在调用前保存当前 GL 状态（着色器、VAO、blend、depth test 等），渲染完立即恢复；
imgui_impl_opengl3.cpp默认做了部分保存，但如果你用了自定义 pipeline，得手动 wrap - Vulkan 下：不能把
ImGui::Render()产生的 draw command 直接vkQueueSubmit()；必须在你自己的 render pass 中预留 subpass，或复用 secondary command buffer，并确保 descriptor set 已绑定 ImGui 字体纹理 - 常见黑屏原因：调用
ImGui_ImplOpenGL3_RenderDrawData()前没清空 color/depth buffer，导致 UI 被你自己的背景盖住；或者你在 UI 渲染后又调了一次glClear()
调试时先弹 DemoWindow，但别让它干扰主逻辑
ImGui::ShowDemoWindow() 是验证集成是否成功的最快方式，但它默认每帧都画满屏、占大量 CPU/GPU。上线前必须关掉，且不能靠 #ifdef DEBUG 简单包裹——因为它的内部会分配临时缓冲、创建字体纹理，未清理会导致内存泄漏。
- 正确做法：用布尔变量控制显隐，例如
static bool show_demo = false;，在 UI 里放个按钮切换；退出时调用ImGui::DestroyContext()前确保show_demo为 false - Release 构建中建议完全移除对
imgui_demo.cpp的链接，避免符号污染和体积膨胀 - 如果
ShowDemoWindow()能弹出但自定义控件不响应，大概率是ImGui::GetIO().DeltaTime没设对（导致帧率识别异常）或MousePos始终为负值（窗口尺寸没同步）
最易被忽略的一点：DPI 缩放。Windows 高分屏或 macOS Retina 下，glfwGetFramebufferSize() 返回的像素尺寸 ≠ glfwGetWindowSize() 返回的逻辑尺寸，而 ImGui_ImplOpenGL3_NewFrame() 默认用 framebuffer size 计算缩放。如果你没调用 ImGui::GetIO().FontGlobalScale 手动校正，字体和控件会糊成一团——这问题在开发机上不出现，一到客户机器就暴露。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
