桌面应用 / 系统课时

用 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;如果处理大量数据文件,应考虑流式读取,避免一次性加载全部内容造成内存压力。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 QFile 读写文本文件

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

登录哪都通