Qt 文件操作详解:从基础类到读写实战

作者:时间的拾荒人日期:2026/10/5

📑 目录

  • 🚀 1. 引言
  • 📁 2. 输入输出设备类
  • ✏️ 3. 文件读写类
  • 📖 4. 示例1:读取文件内容
  • 📝 5. 示例2:写文件
  • 📂 6. 文件和目录信息类
  • ☁️ 7. 总结
  • 🌲 8. 经典面试题

🚀 1. 引言

文件操作是应用程序必不可少的部分。Qt 作为一个通用开发库,提供了跨平台的文件操作能力。Qt 提供了很多关于文件的类,通过这些类能够对文件系统进行操作,如文件读写、文件信息获取、文件复制或重命名等。本文将系统介绍 Qt 中文件操作相关的核心类、继承关系以及实际应用示例。

📁 2. 输入输出设备类

在 Qt 中,文件读写的类为 QFile。QFile 的父类为 QFileDevice,QFileDevice 提供了文件交互操作的底层功能。QFileDevice 的父类是 QIODevice,QIODevice 的父类为 QObject。

QIODevice 是 Qt 中所有输入输出设备(input/output device,简称 I/O 设备)的基础类。I/O 设备就是能进行数据输入和输出的设备,例如文件是一种 I/O 设备,网络通信中的 socket 是 I/O 设备,串口、蓝牙等通信接口也是 I/O 设备,所以它们也是从 QIODevice 继承来的。

Qt 中主要的一些 I/O 设备类的继承关系如下图所示:

上图中各类的说明如下:

  • QFile:用于文件操作和文件数据读写的类,使用 QFile 可以读写任意格式的文件。
  • QSaveFile:用于安全保存文件的类。使用 QSaveFile 保存文件时,它会先把数据写入一个临时文件,成功提交后才将数据写入最终的文件。如果保存过程中出现错误,临时文件里的数据不会被写入最终文件,这样就能确保最终文件中不会丢失数据或被写入部分数据。在保存比较大的文件或复杂格式的文件时可以使用这个类,例如从网络上下载文件等。
  • QTemporaryFile:用于创建临时文件的类。使用函数 QTemporaryFile::open() 就能创建一个文件名唯一的临时文件,在 QTemporaryFile 对象被删除时,临时文件被自动删除。
  • QTcpSocket 和 QUdpSocket:分别实现了 TCP 和 UDP 的类。
  • QSerialPort:实现了串口通信的类,通过这个类可以实现计算机与串口设备的通信。串口是比较古老的通信方式,一般在嵌入式系统上面开发板,通过串口和开发板之间进行交互。
  • QBluetoothSocket:用于蓝牙通信的类。手机和平板计算机等移动设备有蓝牙通信模块,笔记本电脑一般也有蓝牙通信模块。通过 QBluetoothSocket 类,就可以编写蓝牙通信程序,如编程实现笔记本电脑与手机的蓝牙通信。
  • QProcess:用于启动外部程序,并且可以给程序传递参数。相当于对 fork() 和 exec 操作进行封装。
  • QBuffer:以一个 QByteArray 对象作为数据缓冲区,将 QByteArray 对象当作一个 I/O 设备来读写。

✏️ 3. 文件读写类

在 Qt 中,文件的读写主要是通过 QFile 类来实现。在 QFile 类中提供了一些用来读写文件的方法。对于文件的操作主要有:

  • 读数据:QFile 类中提供了多个方法用于读取文件内容,如 read()、readAll()、readLine() 等。
  • 写数据:QFile 类中提供了多个方法用于往文件中写内容,如 write()、writeData() 等。
  • 关闭文件:文件使用结束后必须用函数 close() 关闭文件。

访问一个设备之前,需要使用 open() 函数打开该设备,而且必须指定正确的打开模式。QIODevice 中所有的打开模式由 QIODevice::OpenMode 枚举变量定义,其取值如下:

打开模式说明
QIODevice::NotOpen没有打开设备
QIODevice::ReadOnly以只读方式打开设备
QIODevice::WriteOnly以只写方式打开设备
QIODevice::ReadWrite以读写方式打开设备
QIODevice::Append以追加方式打开设备,数据将写到文件末尾
QIODevice::Truncate每次打开文件后重写文件内容,原内容将被删除
QIODevice::Text在读文件时,行尾终止符会被转换为 '\n';当写入文件时,行尾终止符会被转换为本地编码。如 Win32 上为 '\r\n'
QIODevice::Unbuffered无缓冲形式打开文件,绕过设备中的任何缓冲区
QIODevice::NewOnly文件存在则打开失败,不存在则创建文件

📖 4. 示例1:读取文件内容

  1. 新建 Qt 项目,在 UI 文件中拖入一个 LineEdit,一个 pushButton,一个 TextEdit。当点击按钮时,弹出窗口选择要读取的文件,并将读取到的内容在 TextEdit 中显示;
  2. 在 “widget.cpp” 文件中实现对应功能;
1#include "widget.h"
2#include "ui_widget.h"
3#include<QFileDialog>
4Widget::Widget(QWidget *parent)
5    : QWidget(parent)
6    , ui(new Ui::Widget)
7{
8    ui->setupUi(this);
9
10    connect(ui->pushButton,&QPushButton::clicked,[=](){
11        QString path = QFileDialog::getOpenFileName(this,//对话框的父类
12                                                    "打开文件", //对话框的标题
13                                                    "D:\\Qt\\tmp" //默认打开文件路径
14                                                    );
15        //将打开的文件路径放到lineEdit中
16        ui->lineEdit->setText(path);
17        //path 代表的是打开的文件的路径
18        QFile file(path);
19        file.open(QIODevice::ReadOnly);//表示以只读的方式打开文件
20        QString str = file.readAll();//读取文件中的所有内容,一次读全部
21        //将读取到的文件内容放到textEdit中
22        ui->textEdit->setText(str);
23        //记得用完要关闭文件!
24        file.close();
25    });
26}
27
28Widget::~Widget()
29{
30    delete ui;
31}
32

实现效果如下:

📝 5. 示例2:写文件

在上述示例的基础上修改 “widget.cpp” 文件;

1#include "widget.h"
2#include "ui_widget.h"
3#include<QFileDialog>
4Widget::Widget(QWidget *parent)
5    : QWidget(parent)
6    , ui(new Ui::Widget)
7{
8    ui->setupUi(this);
9
10    connect(ui->pushButton,&QPushButton::clicked,[=](){
11        QString path = QFileDialog::getOpenFileName(this,//对话框的父类
12                                                    "打开文件", //对话框的标题
13                                                    "D:\\Qt\\tmp" //默认打开文件路径
14                                                    );
15        //将打开的文件路径放到lineEdit中
16        ui->lineEdit->setText(path);
17        //path 代表的是打开的文件的路径
18        QFile file(path);
19        file.open(QIODevice::Append);//表示以追加的方式打开文件
20        //写入文件
21        file.write("【📃这是一个使用Qt写文件的案例】");
22        file.close();
23    });
24}
25
26Widget::~Widget()
27{
28    delete ui;
29}
30

实现效果如下:

📂 6. 文件和目录信息类

QFileInfo 是 Qt 提供的一个用于获取文件和目录信息的类,如获取文件名、文件大小、文件修改日期等。QFileInfo 类中提供了很多的方法,常用的有:

  • isDir():检查该文件是否是目录;
  • isExecutable():检查该文件是否是可执行文件;
  • fileName():获得文件名;
  • completeBaseName():获取完整的文件名;
  • suffix():获取文件后缀名;
  • completeSuffix():获取完整的文件后缀;
  • size():获取文件大小;
  • isFile():判断是否为文件;
  • fileTime():获取文件创建时间、修改时间、最近访问时间等;

示例:在 “widget.cpp” 文件中添加如下代码:

1#include "widget.h"
2#include "ui_widget.h"
3#include<QDebug>
4#include<QDateTime>
5#include<QPushButton>
6#include<QFileDialog>
7#include<QFileInfo>
8#include<QFileDevice>
9
10Widget::Widget(QWidget *parent)
11    : QWidget(parent)
12    , ui(new Ui::Widget)
13{
14    ui->setupUi(this);
15
16    connect(ui->btn,&QPushButton::clicked,[=](){
17        QString path = QFileDialog::getOpenFileName(this,
18                                                    "打开文件",
19                                                    "D:\\Qt\\tmp");
20        //创建一个获取文件信息的QFileInfo对象
21        QFileInfo fileInfo(path);
22        //1.获取文件名
23        qDebug()<<"文件名:"<< fileInfo.fileName().toUtf8().data();
24        //2.文件后缀名
25        qDebug()<<"当前文件的后缀名是:"<<fileInfo.suffix().toUtf8().data();
26        //3.文件大小
27        qDebug()<<"文件大小是:"<<fileInfo.size();
28        //5.文件路径
29        qDebug()<<"文件路径:"<<fileInfo.path().toUtf8().data();
30        //6.是否是文件
31        qDebug()<<"是否是文件:"<<fileInfo.isFile();
32        //7.是否是目录
33        qDebug()<<"是否是目录:"<<fileInfo.isDir();
34        //8.文件创建时间
35        QDateTime creaate_time = fileInfo.fileTime(QFileDevice::FileBirthTime);
36        qDebug()<<"创建时间为:"<<creaate_time.toString("yyyy-MM-dd hh:mm::ss").toUtf8().data();
37        //9.文件的修改时间
38        QDateTime modify_time = fileInfo.lastModified();
39        qDebug()<<"文件最后的修改时间:"<<modify_time.toString("yyyy-MM-dd hh:mm:ss");
40    });
41}
42Widget::~Widget()
43{
44    delete ui;
45}
46

实现效果如下:

☁️7. 总结

本文详细介绍了 Qt 中文件操作的核心知识
,包括 QIODevice 及其子类的继承体系、QFile 的读写方法、打开模式枚举,以及 QFileInfo 获取文件信息的方法。通过读取文件、写入文件和获取文件信息三个实战示例,相信读者已经掌握了 Qt 文件操作的基本流程。在实际开发中,根据需求选择合适的类和方法,就能高效地完成文件相关的功能。

🌲8. 经典面试题

面试题1:QFile 与 QSaveFile 有什么区别?分别在什么场景下使用?

参考答案:

QFile 是 Qt 中最基础的文件读写类,直接对文件进行读写操作,适用于大多数普通文件读写场景。而 QSaveFile 是用于安全保存文件的类,它先把数据写入一个临时文件,成功提交后才将数据写入最终文件。如果保存过程中出现错误,临时文件里的数据不会被写入最终文件,从而确保最终文件不会丢失数据或被写入部分数据。

适用场景: 当需要写入大量数据,或写入过程中一旦出错会导致原文件损坏时,应优先使用 QSaveFile。例如从网络上下载文件、保存配置文件等场景。而普通的小文件读写,使用 QFile 即可。

面试题2:QIODevice::OpenMode 中 Append 和 Truncate 有什么区别?

参考答案:

  • QIODevice::Append:以追加方式打开设备,数据将写到文件末尾,原有内容保留。
  • QIODevice::Truncate:每次打开文件后重写文件内容,原内容将被删除。

注意: 两者不能同时使用。如果以 Append 方式打开,写入的数据会追加到文件末尾;如果以 Truncate 方式打开,文件原有内容会被清空,再写入新数据。

面试题3:QFile 读取文件时,read()、readAll()、readLine() 有什么区别?

参考答案:

  • read(qint64 maxSize):从文件中读取最多 maxSize 字节的数据,适合分块读取大文件,避免一次性加载过多内容导致内存占用过高。
  • readAll():一次性读取文件中的所有内容,返回一个 QByteArray。适合读取小文件,简单方便。
  • readLine():读取一行数据,以换行符为分隔。适合逐行处理文本文件,如日志文件、配置文件等。

实际建议: 对于大文件,应使用 read() 分块读取;对于小文件,可以直接使用 readAll();对于文本文件需要逐行处理时,使用 readLine() 更高效。

面试题4:QFileInfo 中 fileName()、completeBaseName()、suffix()、completeSuffix() 有什么区别?

参考答案:

假设文件路径为 C:\Users\Lenovo\Desktop\example.tar.gz:

  • fileName():返回文件名,包含所有后缀,结果为 example.tar.gz。
  • completeBaseName():返回完整的文件名(不含后缀),结果为 example.tar。
  • suffix():返回最后一个后缀名,结果为 gz。
  • completeSuffix():返回完整的后缀名,结果为 tar.gz。

记忆技巧: 带 complete 前缀的方法返回更完整的信息,completeBaseName() 返回去掉最后一个后缀的文件名,completeSuffix() 返回所有后缀。

面试题5:使用 QFile 读写文件时,为什么一定要调用 close()?如果不调用会怎样?

参考答案:

close() 用于关闭文件,释放文件句柄。如果不调用 close(),文件句柄会一直占用,可能导致以下问题:

  1. 资源泄漏:文件句柄是系统资源,不释放会导致资源耗尽,尤其是在循环中反复打开文件时。
  2. 数据丢失:写入的数据可能还停留在缓冲区中,没有真正写入磁盘,关闭文件时才会刷新缓冲区。
  3. 文件被占用:文件一直被占用,其他程序无法访问或删除该文件。

注意: 在 Qt 中,QFile 对象被销毁时,析构函数会自动调用 close(),但为了代码清晰和及时释放资源,建议在文件使用完毕后显式调用 close()。

面试题6:QTemporaryFile 有什么特点?它的临时文件什么时候会被删除?

参考答案:

QTemporaryFile 是用于创建临时文件的类。使用 QTemporaryFile::open() 就能创建一个文件名唯一的临时文件,避免文件名冲突。它的特点是:

  • 文件名唯一,不会与其他文件冲突。
  • 当 QTemporaryFile 对象被销毁时,临时文件会被自动删除,无需手动清理。

适用场景: 程序运行过程中需要临时存储数据,且不需要长期保留的场景,例如缓存数据、中间结果等。


参考文档


《Qt 文件操作详解:从基础类到读写实战》 是转载文章,点击查看原文。


相关推荐


CTF题目《UnserializeThree》(BUUCTF Web 困难 反序列化)
Hum8le2026/9/27

DASCTF 上传题(Hack Me)—— phar 反序列化 getshell 详细题解 面向零基础读者的一步步解析。每一步都会先说明「看到什么」,再说明「为什么这样做」,最后给出「具体怎么做」。 〇、先看结论(TL;DR) 考点:文件上传 + phar:// 反序列化 触发 __destruct,配合 eval 执行任意命令。绕过点:preg_match 只过滤了换行符 \n,但 PHP 的 # 注释遇到回车符 \r(0x0D) 也会结束,于是用 \r 就能「逃出注释」执行代码。关键坑


改了工作流引擎的流程定义,在跑的审批单有的跟着变、有的不变
mldong2026/9/21

做过工作流引擎的,都遇到过这么一个瞬间: 周一把审批流程从"两级审批"改成"三级审批",发布了。周二早上,业务同学问:昨天那 20 张还在审批中的单子,现在走两级还是三级? 如果你的引擎回答不了这个问题,或者回答得很随意——那多半是设计时就没想过"定义"和"正在用这份定义跑着的实例"是两回事。 这篇文章做的事,就是把这个问题在 jeeflow 里拆到底:一条在跑的审批单,它到底"记着"流程定义的什么;改了定义之后,下一次它走到引擎时,引擎读到的到底是新版还是旧版。拆完你会发现一个反直觉的结论——


Python 进阶:海象运算符与模式匹配,让你的代码更优雅!
90后晨仔2026/9/13

摘要:Python 3.8 引入的海象运算符 := 和 3.10 引入的模式匹配 match-case,是近年来 Python 语法层面最重要的两次革新。本文将从实战角度出发,详解这两个特性的核心用法、最佳实践及避坑指南,助你写出更简洁、更具表现力的 Pythonic 代码。 💡 前言 作为一名 Python 开发者,你是否经历过以下场景: 为了在 if 判断后复用某个计算结果,不得不提前写一行赋值语句; 面对复杂的嵌套数据结构,写了一长串 if-elif-else 来判断类型和解包数据,


NestJS 12升级踩坑:从Webpack到Rspack,我折腾了一整个周末
Flynt2026/9/5

说实话,看到NestJS 12的changelog时我是有点兴奋的。 8月27号发布,ESM-first、Rspack替代Webpack、Standard Schema验证、@nestjs/observe原生可观测性——每一条都戳在痛点上。特别是Rspack替代Webpack那条,我心想:终于不用等turbopack慢吞吞地编译了。 然后我花了整个周末才把项目跑起来。 先说下项目情况:一个中等体量的B端后台系统,NestJS 11.2.0 + Webpack monorepo架构,用了NATS消


别把豆包当聊天用了,现在的豆包和以前不一样了
程序员晓凡2026/8/28

大家好,我是晓凡。 豆包算是全民 AI 应用了,上班族、老人、小孩,手机里基本人手一个。我很早就给爸妈装上了,他们用得特别顺手,用他们的话说,豆包正好用,什么都懂。以前手机字体怎么调大、照片怎么发到家庭群、体检报告上的箭头是什么意思,这些事他们都要打电话来问我,现在直接跟豆包语音聊,问完自己就能搞定。 不过最近我才发现,豆包又悄悄更新了一大波东西:能操作本地电脑、使用浏览器,支持调用 Skills 技能和定时任务,内置了 Office 办公套件,还支持专业的图片视频设计。 不知道你是不是和我一样


Android 架构进阶:为什么项目越大,越需要把对象创建权拿走
潜龙勿用之化骨龙2026/8/20

刚开始写 Android 项目的时候,我其实不太理解 DI 有什么必要。 一个对象而已: val repository = UserRepositoryImpl() 直接创建不就完了吗? 如果只是一个小项目,确实没什么问题。 甚至我觉得,这时候为了 Hilt、Koin 再引入一套依赖注入体系,反而有点重。 真正让我改变想法的,是项目开始变大以后。 你会发现,项目变复杂以后,麻烦来了: 到处都是创建对象。 一、项目小的时候,直接创建对象没有问题 比如: class UserRepository


Java对象头Mark Word状态与锁膨胀过程剖析
wuminyu2026/8/6

Java对象头Mark Word状态与锁膨胀过程剖析 前言对象头Mark Word状态与锁膨胀过程剖析1. 64位 HotSpot JVM 下 Mark Word 内存布局64位 JVM Mark Word 位结构图表C++ 头文件位常量定义 (`markOop.hpp`) 2. 状态机迁移全景与锁演进路线3. 偏向锁(Biased Locking)的加锁与撤销源码解析3.1 偏向锁的快速进入(Fast Path)3.2 偏向锁的撤销(Revocation) 4. 轻量级锁(Lig


2026 哪个远程控制软件好用?国内海外 6 款主流远程软件深度测评(附评分表与选型建议)
禁止默2026/7/28

2026 年了,远程控制软件早就不是"偶尔帮老妈修电脑"的低频工具了——居家连公司工位改方案、出差路上用平板回邮件、周末秒回 OA、被控端跑训练任务、远程串流玩 3A,这些场景已经把远程软件变成了天天开的生产力底座。 但"哪个好用"这个问题在 2026 年变得更难回答了,原因是市场出现了三条暗线: 国内三巨头分层明显:UU 远程靠网易的网络底子杀进来,把 4K/144fps、端口映射、远程终端全做成了免费;ToDesk 免费版开始卡时长;向日葵免费版广告越塞越多,并且开始排队收费。


让家里网速有据可查:用MySpeed做一个24小时测速看板
是店小二呀2026/7/20

前言 很多人办理宽带时看到的是500M、1000M,可真正用起来却不是那么回事。晚上看视频卡顿,家里多人同时上网就变慢,联系运营商时,对方一句“后台检测正常”,问题往往就很难继续推进。 问题不一定出在你不会测速,而是普通测速方式很难留下连续证据。偶尔打开第三方测速网站测一次,只能说明当时那一刻的结果,不能反映一天内不同时段的波动,也很难判断是不是晚高峰、Wi-Fi环境或线路质量造成的影响。 如果家里本来就有群晖NAS,可以把它变成一台长期在线的测速服务器。MySpeed就是适合这种场景的轻


PDF解析实现
马里马里奥-2026/7/12

1. 项目背景与需求分析 在现代Web应用中,PDF 文档处理是一个常见但复杂的需求。无论是企业 OA 系统、在线教育平台还是知识管理工具,都需要能够高效解析 PDF 内容。本次作业要求实现一个中间件,专门处理前端上传的PDF文件,具体要求如下: 输入格式:接收 Base64 编码的 PDF 数据核心功能:将 Base64 转换为正常 PDF 文件并提取文本内容输出要求:将提取的文本内容完整放入 system_message 中,作为后续对话的上下文扩展目标:最终版本应支持上传或发送包含完整

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读