桌面应用 / 系统课时

用 QFileDialog 选择文件

用 QFileDialog 选择文件

本篇介绍如何在 Qt 6 应用中调用系统文件选择对话框,让用户选择需要读取或保存的文件,并将返回路径连接到后续业务逻辑中。

学习目标

  • 理解 QFileDialog 的作用和常用选择模式。
  • 掌握打开文件、保存文件和选择目录的基本调用方式。
  • 能够将用户选择的路径接入文件读写流程。

认识 QFileDialog 的使用场景

桌面应用通常不能假设用户文件位于固定路径。例如文本编辑器需要打开任意文档,图片工具需要加载用户选择的图片,配置管理工具需要导出指定位置的文件。

QFileDialog 提供了跨平台的文件选择界面。它会调用当前操作系统对应的文件浏览器,并返回用户最终选择的文件路径。

常用静态函数包括:

方法 用途
getOpenFileName 选择一个已有文件
getOpenFileNames 选择多个已有文件
getSaveFileName 选择保存文件路径
getExistingDirectory 选择目录

打开文件对话框

下面示例创建一个按钮,点击后打开文件选择窗口,并输出用户选择的文件路径。

cpp
#include <QApplication>
#include <QPushButton>
#include <QFileDialog>
#include <QDebug>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QPushButton button("选择文件");
    QObject::connect(&button, &QPushButton::clicked, [&]() {
        QString filePath = QFileDialog::getOpenFileName(
            nullptr,
            "选择文档",
            "<PATH>",
            "文本文件 (*.txt);;所有文件 (*)"
        );

        if (!filePath.isEmpty()) {
            qDebug() << "选择文件:" << filePath;
        }
    });

    button.show();
    return app.exec();
}

其中 <PATH> 表示默认打开目录,实际项目中可以替换为应用工作目录或用户目录。

预期输出

text
选择文件: "<PATH>/example.txt"

将选择结果接入文件读取流程

文件选择只负责获取路径,真正读取内容仍需要使用 QFile。常见流程是:

  1. 用户通过 QFileDialog 选择文件。
  2. 判断返回路径是否为空。
  3. 使用 QFile 打开文件。
  4. 读取数据并交给界面或业务层处理。

处理保存路径选择

保存文件时应该使用 getSaveFileName,因为它允许用户指定目标文件名和位置。

保存流程中通常需要额外检查文件是否已经存在,根据业务决定是否覆盖。

使用 QFileDialog 时的常见问题

如果窗口中调用 QFileDialog 后界面无响应,通常是因为在主线程中执行了耗时文件处理。文件选择本身较快,但读取大文件或解析复杂数据时,应考虑异步处理。

如果默认目录不符合预期,应检查传入的第三个参数。传入空字符串时,Qt 会根据平台规则选择默认位置。

QFileDialog 适合负责用户交互和路径获取,而文件内容处理应由独立的文件处理模块完成,这样可以让界面逻辑保持简单。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 QFileDialog 选择文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通