必须先匹配并初始化对应渲染后端（如imgui_impl_dx11.cpp或imgui_impl_opengl3.cpp），再调用ImGui::CreateContext()；否则因缺乏渲染驱动将导致崩溃或黑屏。
ImGui 初始化前必须确认渲染后端是否匹配
ImGui 本身不负责渲染，它依赖你已有的 DirectX 或 OpenGL 上下文。如果直接调用 ImGui::CreateContext() 后就试图渲染，会崩溃或黑屏——因为没告诉 ImGui 用哪个后端、也没绑定渲染函数。关键不是“能不能初始化”，而是“初始化后能否被正确驱动”。
- DirectX 9/10/11/12 和 OpenGL 2/3/4 都有对应官方后端，路径在
imgui/backends/下，比如imgui_impl_dx11.cpp或imgui_impl_opengl3.cpp - 必须 #include 对应的 backend 头文件，且链接对应的 .cpp（不能只靠头文件）
- OpenGL 后端默认启用 gl3w 或 glad，如果你用的是
gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)这类加载方式，要确保在调用ImGui_ImplOpenGL3_Init()前已完成 OpenGL 函数地址加载
DirectX 11 环境下初始化三步不可少
以 DX11 为例，常见错误是只初始化了 ImGui 上下文，却忘了把设备和上下文传给后端，导致 ImGui_ImplDX11_NewFrame() 内部访问空指针。
- 先调用
ImGui::CreateContext()，再调用ImGui_ImplDX11_Init(device, deviceContext)，两个参数必须是非空 ID3D11Device* 和 ID3D11DeviceContext* - 在主渲染循环中，每帧开始前调用
ImGui_ImplDX11_NewFrame()，之后才是ImGui::NewFrame() - 渲染时顺序不能错：先你的 3D 场景 → 再
ImGui::Render()→ 最后调用ImGui_ImplDX11_RenderDrawData(ImGui::GetDrawData())；否则 UI 会被深度测试剔除或覆盖
OpenGL 3+ 初始化要注意着色器和上下文版本
ImGui_ImplOpenGL3_Init() 默认假设你使用 GLSL 150（即 OpenGL 3.2+），如果你的上下文是 OpenGL 3.0（GLSL 130），它会编译失败并静默返回 false，但不会报错提示。
- 初始化前检查
glGetString(GL_SHADING_LANGUAGE_VERSION)，确保版本 ≥ “1.50”；否则需修改imgui_impl_opengl3.cpp中的glsl_version参数，例如传"#version 130" - 调用
ImGui_ImplOpenGL3_Init("#version 150")时字符串必须带#version前缀，漏掉会导致着色器编译失败 - 若使用 GLFW，确保在创建窗口时设置了
glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3)和glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3)，否则可能拿到兼容性上下文，导致 glBindSampler 等函数不可用
多个窗口或子窗口场景下容易忽略的资源绑定
如果你的程序有多个 OpenGL/DX 窗口（比如编辑器多视图），每个窗口都需要独立的 ImGui 上下文和后端实例——但绝大多数人只初始化一次，结果 UI 只在一个窗口显示，或切换窗口后崩溃。
立即学习“C++免费学习笔记（深入）”；
- 每个窗口应有自己的
ImGuiContext*，用ImGui::CreateContext()创建，并用ImGui::SetCurrentContext(ctx)切换 - 每个窗口也要各自调用对应的
ImGui_ImplXXX_Init()，并保存其返回状态；ImGui_ImplXXX_Shutdown()也必须成对调用 - OpenGL 下尤其注意：不同窗口可能使用不同上下文，
ImGui_ImplOpenGL3_Init()必须在目标上下文激活后调用（即wglMakeCurrent或glfwMakeContextCurrent之后）
很多项目卡在“初始化成功但没显示”，其实问题不在 ImGui::CreateContext()，而在后端初始化失败却没检查返回值，或者渲染循环里漏掉了 ImGui_ImplXXX_RenderDrawData() 这一行。
