📌 项目地址：ocornut/imgui | ⭐ 75,164 颗星 | 🔧 C++ | 📜 未标注
什么是 Dear ImGui
Dear ImGui 是一个基于 即时模式 的图形用户界面库，专为 C++ 开发者在 OpenGL、DirectX、Vulkan 等渲染环境中快速构建调试工具、编辑器面板和监控界面而设计。它的核心特点写在名字里：Bloat-free（无冗余）和 minimal dependencies（最小依赖）—— 整个库只依赖一个头文件和几个源文件，不绑定任何窗口系统或事件循环。GitHub 75k+ Star 的体量说明它已是该领域的事实标准。
谁需要它：不仅仅是游戏开发者
很多人以为 Dear ImGui 只服务于游戏引擎编辑器，但实际它的典型场景是：任何需要“运行时可视化与控制”的 C++ 程序。例如：
- 3D 渲染引擎的帧率调试器、材质参数调节面板
- 视频处理工具的实时滤镜参数滑杆
- 物理仿真的碰撞体碰撞开关、重力系数输入框
- 嵌入式硬件模拟器的寄存器查看器
这类场景的共同痛点是：如果使用 Qt 或 wxWidgets 等传统保留模式框架，你需要维护一个事件循环、管理父子窗口层次、处理回流和重绘。而在一个已有的 OpenGL 循环里嵌入一个调试面板，一个 ImGui::Button 调用就能直接渲染并返回点击状态，同时你不需要修改主循环结构。
核心用法：三分钟上手
以下代码取自 README 的“Integration”示例，展示最小集成步骤：
// 1. 创建 Dear ImGui 上下文
IMGUI_CHECKVERSION();
ImGui::CreateContext();
ImGuiIO& io = ImGui::GetIO();
io.Fonts->AddFontDefault();
// 2. 在每个渲染帧开始时调用
ImGui_ImplOpenGL3_NewFrame();
ImGui_ImplGlfw_NewFrame();
ImGui::NewFrame();
// 3. 创建你的 UI
{
ImGui::Begin("Hello, world!");
ImGui::Text("This is some useful text.");
ImGui::Button("Click me");
ImGui::End();
}
// 4. 渲染前的最后一步
ImGui::Render();
ImGui_ImplOpenGL3_RenderDrawData(ImGui::GetDrawData());
注意上面的 ImGui_ImplOpenGL3_ 和 ImGui_ImplGlfw_ 是 官方提供的后端绑定，用于将 ImGui 接入实际窗口系统和图形 API。你可以根据自己使用的平台自由选择（GLFW+OpenGL、SDL+DirectX、GLFW+Vulkan 等），这些绑定代码在仓库的 backends/ 目录下。
更完整的入门可以参考官方 “dear imgui 的自述文件和入门示例”（在仓库根目录 examples/ 文件夹），以及内置的 ImGui::ShowDemoWindow() 函数，调用它即可打开一个包含所有控件演示的交互窗口。
为什么它比 Qt 更适合某些工作：即时模式 vs 保留模式
| 对比维度 | Dear ImGui（即时模式） | Qt（保留模式） |
|---|---|---|
| 依赖大小 | 仅头文件 + 6个源文件 | 数十 MB 动态库 |
| 状态管理 | 每帧重新构建窗口，无需维护 widget 树 | 对象层级持久，需管理信号槽和布局 |
| 集成成本 | 只需在渲染循环中加入几个函数调用 | 需要接管主循环或嵌入事件系统 |
| 多线程支持 | 官方不保证线程安全，推荐单线程使用 | 内置 QThread 等机制 |
这并不是说 Dear ImGui 能替代 Qt。如果你要做的是文档编辑器、项目管理器这类 长期运行且 UI 状态复杂 的桌面应用，Qt 的保留模式能让你少写很多状态同步逻辑。而 Dear ImGui 的即时模式意味着 UI 代码与逻辑代码高度耦合，每次帧循环都会重新创建所有窗口，更适合那些 UI 只是辅助功能（而非主交互）的场景。
需要注意的几点（来自 README 和社区经验）
-
许可证：MIT 许可证，商业友好。源码中公开了 License，无需额外付费。
-
并非面向终端用户：官方反复强调“本库是为工具而不是为最终用户应用设计的”。按钮没有原生风格的阴影、圆角、渐变，一切以简洁和高效为目标。如果要生产产品级 UI，需要结合自己的样式系统（可以通过
ImGui::GetStyle()覆写颜色和尺寸）。 -
无内置平台支持：它不替你创建窗口或处理输入事件。你需要自己用一个后端（如 GLFW、SDL、Win32）来提供
io.DisplaySize、io.MouseDown等数据。官方backends/提供了常见组合，这是 必须 引入的部分。 -
没有稳定 API 保证：虽然 ImGui 很成熟，但新版本可能会修改函数签名，你需要跟随更新。官方文档说得很清楚：“我们努力保持向后兼容，但不能保证二进制兼容性。”
-
官方的“如何开始”路径：如果你从零开始，建议复制仓库中
examples/example_glfw_opengl2或example_sdl_opengl3文件夹，直接编译运行。这是最快验证是否适合你项目的办法。
总结
Dear ImGui 不是万能 GUI，而是为 “在已有 C++ 图形程序中快速嵌入低开销调试界面” 这个特定问题给出的优秀答案。它用极简的设计换来了极低的集成门槛，75k Star 的认可度也证明了它的可靠。下一个帧率不稳定的图形应用，或许只需要 5 行代码就能加一个实时性能面板。