桌面应用 / 系统课时
用 QFile 读写文本文件
用 QFile 读写文本文件
本篇解决 Qt 应用中保存和读取本地文本数据的问题。你将使用 QFile 打开文件、读取内容、写入文本,并处理文件不存在或打开失败等实际情况。
学习目标
- 理解 QFile 与 Qt 文件读写流程的关系。
- 掌握文本文件读取和写入的基本代码。
- 学会通过返回值判断文件操作是否成功。
理解 QFile 的文件操作流程
QFile 是 Qt 提供的文件访问类,常用于读取配置文件、保存用户数据或处理应用生成的文本资源。典型流程包括创建 QFile 对象、调用 open 打开文件、读写内容、关闭文件。
文件操作失败时,程序不应该直接继续处理数据,而应该检查 open 返回结果并给出合理处理。
写入文本文件
下面示例将文本写入指定文件。路径中的实际位置应根据运行环境调整。
cpp
#include <QFile>
#include <QTextStream>
#include <QDebug>
int main()
{
QFile file("<PATH>/config.txt");
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
qDebug() << "open failed";
return 1;
}
QTextStream stream(&file);
stream << "theme=dark\n";
file.close();
return 0;
}预期输出
text
程序正常结束,<PATH>/config.txt 中写入 theme=dark读取文本文件内容
读取文件时需要先确认文件存在,并选择合适的打开模式。
cpp
#include <QFile>
#include <QTextStream>
#include <QDebug>
int main()
{
QFile file("<PATH>/config.txt");
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
qDebug() << "read failed";
return 1;
}
QTextStream stream(&file);
qDebug().noquote() << stream.readAll();
return 0;
}预期输出
text
theme=dark处理文件失败情况
文件路径错误、权限不足、文件被占用都可能导致打开失败。实际项目中通常需要根据 QFile 的错误信息记录日志或提示用户。
选择文本文件方案时的注意事项
QFile 适合简单文件读写。如果保存的是复杂配置,可以结合 QSettings;如果处理大量数据文件,应考虑流式读取,避免一次性加载全部内容造成内存压力。
按自己的节奏,确认真正理解。