【亲测免费】探索与创造：ImGuiFileDialog——优雅的文件选择对话框库

2026-01-15 17:40:05作者：蔡丛锟

1、项目介绍

ImGuiFileDialog是一个专为Dear ImGui设计的文件选择对话框库，它的核心目标是提供一个定制化程度极高的界面，让你可以根据文件类型添加自定义控件。这个项目由aiekick开发并维护，支持Windows、Linux和MacOS平台，并且兼容Emscripten，可在Web环境中运行。

2、项目技术分析

ImGuiFileDialog基于Dear ImGui，并紧密跟随其主分支和Docking分支进行更新，目前版本对应于ImGui 1.90.1。它不需要单独编译，可以直接将源代码整合到你的项目中，简化了集成过程。在Windows环境下，项目依赖于dirent v1.23来实现目录操作。

项目结构清晰，分为Master分支（库本身）和DemoApp分支（演示应用），方便开发者理解和使用。CMake构建系统也已整合，轻松集成到各种项目中。

3、项目及技术应用场景

如果你正在开发一个使用Dear ImGui的图形界面工具或游戏引擎，那么ImGuiFileDialog能够帮助你创建功能强大的文件选择界面。例如，你可以：

自定义文件选择面板，根据文件扩展名显示特定的组件。
实现多选模式，通过Ctrl/Shift键选择多个文件。
在不同的操作系统上展示一致的用户体验。
轻松切换文件过滤器，通过预设或自定义规则筛选文件。
使用键盘导航、字符输入探索文件，以及快速访问路径中的某个元素。
集成缩略图查看，增强视觉体验。

4、项目特点

C API：除了C++接口，还提供了C语言API，方便不同语言环境下的使用。
灵活的调用与显示分离：可以设置多个函数调用，但只需要一个显示函数。
自定义扩展：允许创建自定义面板，动态调整界面，甚至根据当前过滤器和用户数据呈现不同内容。
多种操作系统支持：包括Windows、Linux、MacOS和Web浏览器。
丰富的特性：支持模态对话框、文件和目录选择、过滤组、忽略大小写的过滤、确认覆盖等。
高度可配置性：验证按钮位置、宽度、反向顺序等均可定制。
目录书签和手动路径输入，提高用户交互性。
一键切换平行目录：在路径输入框中点击斜杠会弹出选项列表。

通过以下简单示例，您可以快速启动一个文件选择对话框：

if (ImGui::Button("Open File Dialog"))
    ImGuiFileDialog::Instance()->OpenDialog("ChooseFileDlgKey", "Choose File", ".cpp,.h,.hpp", ".");

if (ImGuiFileDialog::Instance()->Display("ChooseFileDlgKey"))
{
  if (ImGuiFileDialog::Instance()->IsOk())
  {
    std::string filePathName = ImGuiFileDialog::Instance()->GetFilePathName();
    // 执行其他操作...
  }
  ImGuiFileDialog::Instance()->Close();
}