ImGui是一个轻量级即时模式GUI库,无需复杂架构即可为C++程序快速添加图形界面。它通过每帧重新绘制控件实现界面交互,代码简洁且与程序逻辑紧密集成,支持OpenGL、Vulkan、DirectX等图形API,并可在Windows、Linux、macOS及嵌入式系统上运行。使用时需引入ImGui、GLFW和图形API库,初始化上下文后在主循环中调用Begin/End、Button、Slider等函数构建界面,配合ImGui::Render完成渲染。其优势在于免UI设计器、跨平台、易集成,特别适合调试工具、参数调节面板等场景。加载自定义字体可解决多平台显示差异问题。

想为C++程序快速添加图形界面,又不想被MFC、Qt的复杂架构拖慢开发节奏?ImGui 是一个轻量、高效、直接集成到代码中的即时模式GUI库,特别适合工具开发、调试界面或原型设计。它不依赖重量级框架,能轻松运行在Windows、Linux、macOS甚至嵌入式系统上。
什么是ImGui?
ImGui(Immediate Mode GUI)不同于传统保留模式GUI(如Qt),它的控件不是持久对象,而是每帧通过代码“绘制”出来的。你每次调用按钮、滑块等函数时,它只在当前帧响应输入并渲染。这种模式让界面逻辑与程序流程紧密结合,写起来像写控制台输出一样直接。
优点包括:
- 代码简洁,界面逻辑集中
- 无需UI设计器或XML文件
- 极容易与OpenGL、Vulkan、DirectX等图形API集成
- 跨平台:Windows/Linux/macOS都支持
- 适合做调试器、游戏工具、参数调节面板
环境搭建与基本结构
以OpenGL + GLFW为例,在主流平台上搭建ImGui环境步骤一致。
立即学习“C++免费学习笔记(深入)”;
1. 获取依赖库:
- ImGui:从 GitHub 下载 https://www.php.cn/link/403ce9727d471b1f704be4396af294ac
- GLFW:处理窗口和输入事件
- OpenGL:用于渲染(或使用DX11/Vulkan)
2. 编译链接:
把 imgui.cpp, imgui_draw.cpp, imgui_widgets.cpp 加入项目,同时包含 backends/imgui_impl_glfw.cpp 和 imgui_impl_opengl3.cpp。
3. 初始化示例(伪代码结构):
glfwInit(); GLFWwindow* window = glfwCreateWindow(1024, 768, "ImGui Demo", NULL, NULL); glfwMakeContextCurrent(window);// 初始化ImGui上下文 IMGUI_CHECKVERSION(); ImGui::CreateContext(); ImGuiIO& io = ImGui::GetIO();
// 设置后端 ImGui_ImplGlfw_InitForOpenGL(window, true); ImGui_ImplOpenGL3_Init("#version 130");
while (!glfwWindowShouldClose(window)) { glfwPollEvents();
// 开始新帧 ImGui_ImplOpenGL3_NewFrame(); ImGui_ImplGlfw_NewFrame(); ImGui::NewFrame(); // 绘制你的界面 ImGui::Begin("Hello"); ImGui::Button("Click Me"); ImGui::End(); // 渲染 ImGui::Render(); glClear(GL_COLOR_BUFFER_BIT); ImGui_ImplOpenGL3_RenderDrawData(ImGui::GetDrawData()); glfwSwapBuffers(window);}
创建实用界面组件
ImGui 提供了丰富的控件,可以直接在循环中调用。
常用控件示例:
-
按钮与交互:
if (ImGui::Button("Start")) running = true; -
滑块调节数值:
ImGui::SliderFloat("Speed", &speed, 0.1f, 10.0f); -
复选框:
ImGui::Checkbox("Enable Debug", &debug_mode); -
下拉选择:
ImGui::Combo("Mode", &mode, "Option A\0Option B\0Option C\0"); -
输入框:
ImGui::InputText("Name", buffer, IM_ARRAYSIZE(buffer));
你可以将这些控件组合成面板,比如监控变量的调试窗口,或配置参数的设置页。
跨平台注意事项
虽然ImGui本身是跨平台的,但窗口和渲染后端需要适配。
- Windows:使用Visual Studio编译,链接opengl32.lib,确保GLFW头文件路径正确
- Linux:安装
libglfw3-dev和libgl1-mesa-dev,g++编译时加-lglfw -lGL - macOS:使用Homebrew安装GLFW,注意Metal后端也可用(需配置对应backend)
字体显示问题常见于不同系统。建议加载自定义字体以保证一致性:
io.Fonts->AddFontFromFileTTF("NotoSansCJK.ttf", 18.0f);
基本上就这些。用ImGui为C++程序加图形界面,不需要复杂的资源管理或UI线程模型,适合快速出效果。只要你会写main函数,就能写出可交互的窗口程序。










