c++ QFile 如果文件路径中的文件夹不存在，会不会自动创建

科学的发展-只不过是读大自然写的代码

已于 2025-03-26 14:31:32 修改

阅读量246

点赞数 1

分类专栏：搜索文章标签： c++ 数据库开发语言

于 2025-03-26 11:44:48 首次发布

本文链接：https://blog.youkuaiyun.com/xie__jin__cheng/article/details/146525028

版权

搜索专栏收录该内容

227 篇文章

订阅专栏

1.概要

2.内容

在使用 C++ 和 Qt 框架时，QFile 类本身不会自动创建文件路径中不存在的文件夹。如果您尝试打开一个文件，而该文件路径中的某些文件夹不存在，QFile::open() 将会失败，并返回 false。

如果您需要自动创建文件路径中的所有必要文件夹，可以在打开文件之前使用 QDir 类来确保路径存在。具体来说，您可以使用 QDir::mkpath() 方法来创建路径中的所有文件夹。

下面是一个示例，演示如何在文件路径不存在时自动创建必要的文件夹：

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

int main() {
    QString filePath = "path/to/nonexistent/folder/example.txt";
    QDir dir = QFileInfo(filePath).dir();

    // 检查目录是否存在，如果不存在则创建
    if (!dir.exists() && !dir.mkpath(dir.absolutePath())) {
        qDebug() << "Failed to create directory path.";
        return -1;
    }

    QFile file(filePath);

    // 以写入模式打开文件，如果文件不存在，将会自动创建
    if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        QTextStream out(&file);
        out << "Hello, World!" << Qt::endl;
        file.close();
        qDebug() << "File created and written successfully.";
    } else {
        qDebug() << "Failed to open file.";
    }

    return 0;
}

在这个示例中：

我们首先使用 QFileInfo(filePath).dir() 获取文件路径的目录部分。
然后检查该目录是否存在。如果不存在，我们使用 dir.mkpath() 创建整个目录路径。
最后，我们尝试以写入模式打开文件。如果一切正常，文件将被成功创建并写入。

通过这种方式，您可以确保在打开文件之前，所有必要的目录都已存在。

3.关联链接

4.关联知识

1.QDir

QDir 是 Qt 框架中用于操作目录和文件路径的核心类，提供了跨平台的文件系统接口。以下是其关键要点和用法详解：

核心功能

目录操作
- 创建目录：mkdir()（单级）、mkpath()（多级递归创建）。
- 删除目录：rmdir()（空目录）、removeRecursively()（递归删除非空目录）。
- 重命名/移动：rename(oldPath, newPath)。
文件操作
- 列出内容：entryList()（文件名列表）、entryInfoList()（详细信息列表）。
- 文件查找：通过过滤器（如 *.txt）筛选特定文件。
- 删除文件：remove()。
路径操作
- 绝对路径：absolutePath()。
- 规范路径：canonicalPath()（解析符号链接和冗余路径）。
- 路径转换：relativeFilePath(fileName, baseDir)（转换为相对路径）。
其他功能
- 存在性检查：exists()。
- 改变目录：cd(dirName)、cdUp()（返回上级目录）。
- 刷新内容：refresh()（更新目录状态）。

代码示例

#include <QDir>
#include <QDebug>

int main() {
    // 创建多级目录
    QDir().mkpath("/path/to/new/directory");

    // 列出目录内容（排除 "." 和 ".."）
    QDir dir("/path/to/directory");
    QStringList entries = dir.entryList(QDir::Files | QDir::Dirs | QDir::NoDotAndDotDot);
    for (const QString &entry : entries) {
        qDebug() << entry;
    }

    // 按文件大小排序并显示详细信息
    dir.setSorting(QDir::Size | QDir::Reversed);
    QFileInfoList fileInfoList = dir.entryInfoList(QDir::Files);
    for (const QFileInfo &info : fileInfoList) {
        qDebug() << "Name:" << info.fileName()
                 << "Size:" << info.size()
                 << "Last Modified:" << info.lastModified();
    }

    return 0;
}

注意事项

路径分隔符
Qt 使用 / 作为通用分隔符，在 Windows 上会自动转换为 \。
权限问题
操作目录或文件时需确保程序有足够的权限。
错误处理
- 检查目录是否存在：if (!QDir(path).exists()) { ... }
- 避免操作不存在的目录或文件。
跨平台兼容性
使用 QDir::separator() 获取系统路径分隔符，增强代码可移植性。

扩展知识

静态方法：
QDir::current()（获取当前工作目录）、QDir::home()（用户主目录）、QDir::root()（根目录）等。
结合 QFileInfo：
获取文件详细信息（如大小、修改时间、权限等）。
深度遍历：
使用 QDirIterator 进行递归遍历，支持广度优先或深度优先搜索。

通过 QDir，开发者可以高效处理文件系统操作，同时保持代码的跨平台兼容性。

2.QFileInfo

QFileInfo 是 Qt 框架中用于获取文件信息的工具类。它提供了与操作系统无关的文件属性，方便开发者获取和处理文件的各种信息，而无需关心底层的操作系统细节。以下是关于 QFileInfo 的详细介绍：

主要功能

QFileInfo 可以获取以下文件信息：

文件名称和路径：
- fileName()：获取文件名（不包括路径）。
- filePath()：获取文件的完整路径（可能包括绝对路径或相对路径）。
- path()：获取文件的路径（不包括文件名）。
- absoluteFilePath()：获取文件的绝对路径。
- absolutePath()：获取文件所在目录的绝对路径。
- dir()：获取文件所在目录的 QDir 对象。
文件类型：
- isFile()：判断是否为普通文件。
- isDir()：判断是否为目录。
- isSymLink()：判断是否为符号链接。
- symLinkTarget()：如果文件是符号链接，返回链接所指向的文件名。
文件大小和时间：
- size()：获取文件大小（以字节为单位）。
- created()：获取文件的创建时间。
- lastModified()：获取文件的最后修改时间。
- lastRead()：获取文件的最后读取时间。
文件权限和所有权：
- isReadable()：判断文件是否可读。
- isWritable()：判断文件是否可写。
- isExecutable()：判断文件是否可执行。
- owner()：获取文件的所有者。
- ownerId()：获取文件所有者的 ID。
- group()：获取文件所属组。
- groupId()：获取文件所属组的 ID。
- permissions()：获取文件的访问权限。
路径类型判断：
- isAbsolute()：判断路径是否为绝对路径。
- isRelative()：判断路径是否为相对路径。
- makeAbsolute()：将相对路径转换为绝对路径。
文件名提取：
- baseName()：获取文件名中的基本名称（不包括后缀）。
- suffix()：获取文件名的后缀。
- completeSuffix()：获取文件名的复合后缀（适用于如 .tar.gz 这样的文件名）。

使用方法

构造函数：
- QFileInfo()：构造一个空的 QFileInfo 对象。
- QFileInfo(const QString &file)：根据提供的文件路径创建一个 QFileInfo 对象。
- QFileInfo(const QFile &file)：根据 QFile 对象创建一个 QFileInfo 对象。
- QFileInfo(const QDir &dir, const QString &file)：根据目录和文件名创建一个 QFileInfo 对象。
设置文件：
- setFile(const QString &file)：设置 QFileInfo 对象指向的文件。
- setFile(const QFile &file)：设置 QFileInfo 对象指向的 QFile 对象。
- setFile(const QDir &dir, const QString &file)：设置 QFileInfo 对象指向的目录和文件名。
检查文件存在性：
- exists()：检查文件是否存在。
刷新文件信息：
- refresh()：重新读取文件信息，以获取最新的文件状态。

示例代码

以下是一个使用 QFileInfo 获取文件信息的示例代码：

#include <QCoreApplication>
#include <QFileInfo>
#include <QDebug>

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    // 创建一个 QFileInfo 对象，并指定文件路径
    QFileInfo fileInfo("/path/to/your/file.txt");

    // 检查文件是否存在
    if (fileInfo.exists()) {
        // 获取并输出文件的各种信息
        qDebug() << "文件名:" << fileInfo.fileName();
        qDebug() << "文件路径:" << fileInfo.filePath();
        qDebug() << "文件大小:" << fileInfo.size() << "字节";
        qDebug() << "文件后缀名:" << fileInfo.suffix();
        qDebug() << "文件创建时间:" << fileInfo.created().toString("yyyy/MM/dd hh:mm:ss");
        qDebug() << "文件最后修改时间:" << fileInfo.lastModified().toString("yyyy/MM/dd hh:mm:ss");
        qDebug() << "文件是否可读:" << fileInfo.isReadable();
        qDebug() << "文件是否可写:" << fileInfo.isWritable();

        // 如果文件是符号链接，输出链接目标
        if (fileInfo.isSymLink()) {
            qDebug() << "符号链接目标:" << fileInfo.symLinkTarget();
        }
    } else {
        qDebug() << "文件不存在";
    }

    return a.exec();
}

注意事项

符号链接处理：在 Unix 系统上（包括 Mac OS X），QFileInfo 会透明地处理符号链接，返回的是链接目标的信息。而在 Windows 上，符号链接（快捷方式）被视为 .lnk 文件，QFileInfo 返回的是 .lnk 文件的信息，而不是链接目标的信息。
性能考虑：某些函数（如 absolutePath()）会查询文件系统，可能会影响性能。如果只需要文件名本身的信息，可以使用其他函数（如 path()）来提高性能。
路径格式：绝对路径以目录分隔符 / 开头（或在 Windows 上以驱动器规范开头），相对路径以目录名或文件名开头。

3.QFile

QFile 是 Qt 框架中用于文件输入/输出操作的类。它提供了对文件进行读取、写入、打开、关闭等操作的功能，是 Qt 中处理文件的基本工具之一。以下是关于 QFile 的详细介绍：

主要功能

文件打开与关闭：
- open()：以指定的模式打开文件（如只读、只写、读写等）。
- close()：关闭文件。
文件读取：
- readLine()：读取文件中的一行。
- readAll()：读取文件中的所有数据。
- read(qint64 maxSize)：读取指定大小的数据。
文件写入：
- write()：将数据写入文件。
- flush()：将缓冲区中的数据写入文件。
文件指针操作：
- seek(qint64 pos)：移动文件指针到指定位置。
- pos()：获取当前文件指针的位置。
- atEnd()：判断文件指针是否在文件末尾。
- resize(qint64 sz)：调整文件大小。
文件状态检查：
- exists()：检查文件是否存在（通过静态方法或实例方法）。
- isOpen()：检查文件是否已打开。
- isReadable() 和 isWritable()：检查文件是否可读或可写。
文件信息获取：
- 虽然 QFile 本身不直接提供文件详细信息（如大小、创建时间等），但可以与 QFileInfo 结合使用。

使用方法

1. 构造函数

QFile()：构造一个空的 QFile 对象。
QFile(const QString &name)：根据文件名构造一个 QFile 对象。

2. 打开文件

使用 open() 方法打开文件，需要指定打开模式：
- QIODevice::ReadOnly：只读模式。
- QIODevice::WriteOnly：只写模式。
- QIODevice::ReadWrite：读写模式。
- QIODevice::Append：追加模式（在文件末尾写入）。
- QIODevice::Truncate：截断模式（打开时清空文件内容）。
- QIODevice::Text：文本模式（处理换行符）。

QFile file("example.txt");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    // 文件打开成功，可以进行读取操作
}

3. 读取文件

逐行读取：

QFile file("example.txt");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    while (!file.atEnd()) {
        QByteArray line = file.readLine();
        qDebug() << line;
    }
    file.close();
}

读取全部内容：

QFile file("example.txt");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    QByteArray data = file.readAll();
    qDebug() << data;
    file.close();
}

4. 写入文件

写入数据：

QFile file("example.txt");
if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    QTextStream out(&file);
    out << "Hello, QFile!" << Qt::endl;
    file.close();
}

追加数据：

QFile file("example.txt");
if (file.open(QIODevice::Append | QIODevice::Text)) {
    QTextStream out(&file);
    out << "Appending a new line." << Qt::endl;
    file.close();
}

5. 文件指针操作

移动文件指针：

QFile file("example.txt");
if (file.open(QIODevice::ReadWrite)) {
    file.seek(10); // 将指针移动到第 10 个字节
    QByteArray data = file.read(5); // 读取接下来的 5 个字节
    qDebug() << data;
    file.close();
}

注意事项

文件模式：
- 打开文件时需要指定正确的模式，否则可能无法读取或写入。
- 例如，只读模式下无法写入文件，只写模式下无法读取文件。
错误处理：
- 使用 error() 方法获取文件操作的错误信息。
- 使用 errorString() 方法获取错误信息的字符串描述。

QFile file("example.txt");
if (!file.open(QIODevice::ReadOnly)) {
    qDebug() << "Error:" << file.errorString();
}

编码问题：
- 默认情况下，QFile 处理的是二进制数据。
- 如果处理文本文件，建议使用 QTextStream 或 QString 进行编码转换。
文件关闭：
- 操作完成后，务必关闭文件以释放资源。
- 可以使用 C++ 的 RAII 原则，确保文件在作用域结束时自动关闭。
性能考虑：
- 对于大文件，避免一次性读取全部内容，应分块读取。
- 写入文件时，及时调用 flush() 确保数据写入磁盘。

示例代码

以下是一个完整的示例，展示如何使用 QFile 读取和写入文件：

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

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    // 写入文件
    QFile file("example.txt");
    if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        QTextStream out(&file);
        out << "Hello, QFile!" << Qt::endl;
        out << "This is a test file." << Qt::endl;
        file.close();
    }

    // 读取文件
    if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        while (!file.atEnd()) {
            QByteArray line = file.readLine();
            qDebug() << line;
        }
        file.close();
    }

    return a.exec();
}

总结

QFile 是 Qt 中处理文件的基本类，提供了丰富的文件操作功能。
支持多种文件操作模式，包括只读、只写、读写、追加等。
可以与 QTextStream 结合使用，方便处理文本文件。
需要注意文件模式、错误处理和资源释放，以确保程序的健壮性。

通过 QFile，开发者可以轻松地实现文件的读取、写入和管理，满足各种文件操作需求。

4.QTextStream

QTextStream 是 Qt 框架中用于文本输入/输出操作的类，它提供了一种方便的方式来读取和写入文本数据。QTextStream 可以与 QFile、QBuffer、QProcess 等设备结合使用，处理文本流。以下是关于 QTextStream 的详细介绍：

主要功能

文本读取：
- 从文本流中逐行或逐块读取数据。
- 支持多种编码格式（如 UTF-8、UTF-16 等）。
文本写入：
- 将文本数据写入流中。
- 支持格式化输出，类似于 C++ 的 std::ostream。
编码处理：
- 自动处理文本编码，确保读取和写入的文本正确显示。
- 支持设置和获取编码格式。
设备独立性：
- 可以与多种设备（如文件、缓冲区、进程）结合使用。
本地化支持：
- 支持本地化的小数点和千位分隔符。

使用方法

1. 构造函数

QTextStream()：构造一个空的 QTextStream 对象。
QTextStream(QIODevice *device)：根据指定的设备（如 QFile）构造一个 QTextStream 对象。

2. 关联设备

使用 setDevice() 方法将 QTextStream 与一个 QIODevice（如 QFile）关联。

QFile file("example.txt");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    QTextStream in(&file);
    // 现在可以使用 in 进行读取操作
}

3. 读取文本

逐行读取：

QFile file("example.txt");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    QTextStream in(&file);
    while (!in.atEnd()) {
        QString line = in.readLine();
        qDebug() << line;
    }
    file.close();
}

读取全部内容：

QFile file("example.txt");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    QTextStream in(&file);
    QString content = in.readAll();
    qDebug() << content;
    file.close();
}

4. 写入文本

写入数据：

QFile file("example.txt");
if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    QTextStream out(&file);
    out << "Hello, QTextStream!" << Qt::endl;
    out << "This is a test file." << Qt::endl;
    file.close();
}

格式化输出：

QFile file("example.txt");
if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    QTextStream out(&file);
    int number = 42;
    double pi = 3.14159;
    out << "Number:" << number << Qt::endl;
    out << "Pi:" << pi << Qt::endl;
    file.close();
}

5. 编码设置

设置编码：

QTextStream stream(&file);
stream.setCodec("UTF-8"); // 设置编码为 UTF-8

获取编码：

QTextCodec *codec = stream.codec();
qDebug() << "Current codec:" << codec->name();

注意事项

设备关联：
- 在使用 QTextStream 之前，必须将其与一个 QIODevice 关联。
- 可以通过构造函数或 setDevice() 方法进行关联。
编码问题：
- 默认情况下，QTextStream 使用本地编码。
- 如果处理非本地编码的文本，需要显式设置编码。
错误处理：
- QTextStream 本身不直接提供错误处理机制，但可以通过关联的 QIODevice 获取错误信息。
性能考虑：
- 对于大文本文件，逐行读取比一次性读取全部内容更节省内存。
- 写入文件时，及时刷新缓冲区（虽然 QTextStream 会在析构时自动处理）。
本地化：
- QTextStream 支持本地化的小数点和千位分隔符，适用于处理不同地区的数字格式。

示例代码

以下是一个完整的示例，展示如何使用 QTextStream 读取和写入文本文件：

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

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    // 写入文件
    QFile file("example.txt");
    if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        QTextStream out(&file);
        out.setCodec("UTF-8"); // 设置编码为 UTF-8
        out << "Hello, QTextStream!" << Qt::endl;
        out << "This is a test file." << Qt::endl;
        out << "Number: 12345" << Qt::endl;
        out << "Pi: 3.14159" << Qt::endl;
        file.close();
    }

    // 读取文件
    if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        QTextStream in(&file);
        in.setCodec("UTF-8"); // 设置编码为 UTF-8
        while (!in.atEnd()) {
            QString line = in.readLine();
            qDebug() << line;
        }
        file.close();
    }

    return a.exec();
}