1、Qt与文件读写初探：认识QFile类，理解文件路径（相对路径与绝对路径），实现第一个“打开文件”按钮。

大家好，我是老张。今天咱们正式开始Qt文件读写的旅程。

说实话，文件读写这玩意儿，在Qt里看着简单，但坑不少。我当年刚入行时，就因为路径问题折腾了一下午——明明文件就在那儿，程序就是打不开。后来才发现，是工作目录搞错了。嗯，今天咱们就从最基础的开始，把这块地基打牢。

1.1 QFile类：Qt文件操作的基石

QFile，说白了就是Qt用来操作文件的类。它继承自QIODevice，所以读写文件的那套接口，跟操作网络、串口啥的，套路差不多。

我个人习惯把QFile理解成「文件句柄的包装器」。你创建一个QFile对象，指定一个路径，然后调用open()，就能开始读写了。关闭时调用close()，干净利落。

核心要点：

QFile 只负责文件本身的操作（打开、关闭、读写）
它不关心文件内容是什么格式——那是你的事
打开模式（ReadOnly、WriteOnly、Append等）决定了你能干什么

来看一个最简单的例子：

#include <QFile>
#include <QTextStream>
#include <QDebug>

void readFile(const QString &filePath) {
    QFile file(filePath);
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        qWarning() << "打开文件失败:" << file.errorString();
        return;
    }
    
    QTextStream in(&file);
    QString content = in.readAll();
    qDebug() << "文件内容:" << content;
    
    file.close();
}

这段代码，我估计你一眼就能看懂。但注意那个QIODevice::Text标志——它告诉Qt，我们按文本模式打开。Windows下换行符是\r\n，加了Text标志，Qt会自动转成\n。我在跨平台项目里吃过这个亏，没加Text标志，结果Windows上读出来的字符串多了回车符，调试了半天。

1.2 文件路径：绝对路径 vs 相对路径

路径问题，是新手最容易踩的坑。咱们先理清概念。

绝对路径：从根目录开始的完整路径。

Windows: C:/Users/YourName/Documents/data.txt
Linux/macOS: /home/yourname/Documents/data.txt

相对路径：相对于程序当前工作目录的路径。

./data.txt 或 data.txt —— 当前目录下的文件
../config/settings.ini —— 上级目录的config文件夹里

为什么会搞混？因为「当前工作目录」这个东西，在IDE里和实际运行时可能不一样。

我记得有一次，在Qt Creator里调试得好好的，路径./config.ini能正常打开。结果打包发布后，用户说程序找不到配置文件。一查，原来Qt Creator默认把工作目录设成了源码目录，而实际运行时，工作目录是exe所在的目录。嗯，这就是相对路径的坑。

避坑指南：

绝对路径：可移植性差，换台电脑就废了
相对路径：依赖工作目录，容易出幺蛾子
我建议：用QCoreApplication::applicationDirPath()获取exe所在目录，再拼接相对路径

比如这样：

QString appDir = QCoreApplication::applicationDirPath();
QString filePath = appDir + "/config/settings.ini";
QFile file(filePath);

这样不管工作目录怎么变，只要配置文件放在exe旁边的config文件夹里，就一定能找到。

1.3 第一个“打开文件”按钮

光说不练假把式。咱们用Qt Designer拖一个按钮，再写几行代码，实现点击按钮弹出文件选择对话框，然后读取文件内容。

先看界面：一个QPushButton，一个QTextEdit（用来显示文件内容）。

然后写槽函数：

// MainWindow.h
private slots:
    void onOpenFileClicked();

// MainWindow.cpp
#include <QFileDialog>
#include <QFile>
#include <QTextStream>
#include <QMessageBox>

void MainWindow::onOpenFileClicked() {
    // 弹出文件选择对话框
    QString filePath = QFileDialog::getOpenFileName(
        this,
        "选择要打开的文件",
        QDir::homePath(),  // 默认打开用户目录
        "文本文件 (*.txt);;所有文件 (*)"
    );
    
    if (filePath.isEmpty()) {
        return;  // 用户取消了选择
    }
    
    // 读取文件
    QFile file(filePath);
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        QMessageBox::warning(this, "错误", "无法打开文件:\n" + file.errorString());
        return;
    }
    
    QTextStream in(&file);
    QString content = in.readAll();
    file.close();
    
    // 显示内容
    ui->textEdit->setPlainText(content);
}

这段代码，我解释一下关键点：

QFileDialog::getOpenFileName —— 标准的文件选择对话框，返回用户选择的路径
QDir::homePath() —— 获取用户主目录，作为对话框的默认路径
文件打开失败时，用QMessageBox弹出错误提示，而不是默默失败
读取完成后记得close()，释放文件句柄

你想想看，这个流程其实就三步：选文件 → 打开文件 → 读内容。但每一步都有细节要注意。比如文件路径为空时直接返回，避免后续操作崩溃。这些经验，都是我在项目里一个个坑填出来的。

1.4 知识体系总览

下面这张图，帮你把本章的核心逻辑串起来：

这张图里，QFile是核心。左边是文件操作的基本流程，中间是路径选择，右边是按钮交互的完整链路。三者结合，就是咱们今天实现的「打开文件」功能。

1.5 小结

今天咱们干了三件事：

认识了QFile类，知道了它怎么打开、读写、关闭文件
搞清楚了绝对路径和相对路径的区别，以及如何避免路径坑
亲手实现了一个「打开文件」按钮，从选择文件到显示内容，一气呵成

嗯，这些东西看着简单，但都是基本功。我见过不少项目，文件路径写死绝对路径，换台电脑就崩；或者打开文件不检查返回值，程序直接崩溃。这些坑，咱们今天都提前避开了。

下一章，咱们会深入QFile的读写模式，看看ReadOnly、WriteOnly、Append这些模式到底有什么区别，以及什么时候该用哪个。到时候见。