imgui需手动对接opengl/vulkan：在正确时机调用imgui::render()并用对应后端渲染；必须使用imgui_impl_opengl3.cpp或imgui_impl_vulkan.cpp，完成状态保存、资源初始化、字体纹理上传及dpi适配；多视口需额外处理窗口与输入事件。
ImGui 与 OpenGL/Vulkan 渲染上下文怎么连上
Imgui 本身不负责渲染，它只生成顶点和纹理数据；你得手动把它的输出喂给 OpenGL 或 Vulkan 的管线。关键不是“加库”，而是“在正确时机调用 ImGui::Render()，再用对应后端的渲染函数画出来”。漏掉绑定纹理、没清空顶点缓冲、或在错误的帧阶段调用，都会导致黑屏、花屏或崩溃。
- OpenGL：必须确保当前有有效的
GLFWwindow*（或自管理的 context），且已调用glGetIntegerv(GL_CURRENT_PROGRAM, &old_prog)等保存/恢复状态——否则 imgui 的着色器会污染你的主渲染流程 - Vulkan：不能直接用
vkQueueSubmit插入 imgui 绘制命令；必须在你自己的 render pass 中预留 subpass 或 secondary command buffer，并确保 descriptor set 已绑定 imgui 的字体纹理 - 常见错误现象：
ImGui::Render()后没看到 UI，但ImGui::ShowDemoWindow()能弹出——大概率是顶点数据没传进 GPU，或 shader 里fragColor被你自己的 blend 模式清掉了
imgui_impl_opengl3.cpp 和 imgui_impl_vulkan.cpp 怎么选和配
这两个文件不是可选插件，是强制依赖项。它们封装了平台相关的资源创建逻辑，比如 OpenGL 下的 VAO/VBO/着色器编译，Vulkan 下的 descriptor pool/layout 创建。不链接它们，ImGui_ImplOpenGL3_Init() 或 ImGui_ImplVulkan_Init() 根本不存在。
- OpenGL：注意
IMGUI_IMPL_OPENGL_LOADER_GLAD宏必须定义，且gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)要在ImGui_ImplOpenGL3_Init()前完成——否则所有 GL 函数调用都是空指针 - Vulkan：
ImGui_ImplVulkan_Init()需要传入VkInstance、VkPhysicalDevice、VkDevice、uint32_t queue_family和VkQueue，少一个就断言失败；特别注意queue_family必须和你提交主渲染命令的 family 一致，否则同步失败 - 参数差异：
ImGui_ImplOpenGL3_Init()第二个参数是着色器版本字符串（如"#version 450"），而ImGui_ImplVulkan_Init()的ImGui_ImplVulkan_InitInfo结构体里必须填MinImageCount和ImageCount，要和 swapchain 保持一致，否则卡死在 acquireNextImage
字体纹理和 DPI 缩放怎么不崩
默认字体太小，缩放后文字模糊或边缘撕裂，本质是纹理采样和 framebuffer 尺寸没对齐。imgui 不自动适配窗口 DPI 变化，得你手动触发重建。
- 字体加载必须在
ImGui_ImplXXX_Init()之后、ImGui_ImplXXX_NewFrame()之前调用io.Fonts->GetTexDataAsRGBA32()——否则ImGui::GetDrawData()返回的TexID是空的 - OpenGL 下如果启用了高 DPI（如 macOS Retina 或 Windows 缩放 150%），要调用
glfwGetFramebufferSize()获取真实像素尺寸，并用它设置io.DisplaySize，否则鼠标坐标和绘制区域错位 - Vulkan 下更麻烦：字体纹理必须创建为
VK_IMAGE_USAGE_TRANSFER_DST_BIT | VK_IMAGE_USAGE_SAMPLED_BIT，且 transition 到VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL后才能绑定到 descriptor；漏掉 barrier，GPU 读到的是脏数据 - 常见错误现象：
ImGui::Text("hello")显示方块或空白——90% 是字体纹理没上传成功，或 sampler 的magFilter设成了VK_FILTER_NEAREST导致缩放失真
多视口（Docking）启用后为啥窗口拖不动或崩溃
多视口不是开个宏就完事。它会让 imgui 创建额外的 GLFW 窗口（OpenGL）或 Vulkan surface（Vulkan），并接管原生窗口消息。一旦你项目里已有自己的窗口管理逻辑，冲突几乎必然发生。
- 必须定义
IMGUI_HAS_VIEWPORT并启用io.ConfigFlags |= ImGuiConfigFlags_ViewportsEnable，但更重要的是：OpenGL 下要调用ImGui_ImplOpenGL3_CreateFontsTexture()两次（主窗口 + 子窗口），Vulkan 下每个 viewport 对应一个VkSurfaceKHR，需单独创建 swapchain - 常见错误现象：拖动子窗口时主窗口冻结——因为你没在主循环里调用
ImGui_ImplGlfw_NewFrame()和ImGui_ImplOpenGL3_NewFrame()（或 Vulkan 对应函数）两次；或者没处理GLFW_TRANSPARENT_FRAMEBUFFER属性，导致子窗口背景不透明、遮挡底层 - 性能影响：每个 viewport 默认独占一个 command buffer，Vulkan 下易触发 descriptor set overflow；建议限制最大 viewport 数（
io.ConfigViewportsNoAutoMerge = true），并复用 descriptor pool
最常被忽略的点：imgui 的输入事件（鼠标/键盘）必须由你转发给 ImGui_ImplGlfw_ProcessEvent()（OpenGL）或自行解析 VkEvent（Vulkan），而不是只依赖 ImGui::NewFrame()。少这一句，Docking 拖拽、右键菜单、文本输入全失效。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
