如何用QList存储QFile？代码构建失败的修复及方案合理性分析

问题场景 #

尝试用QList<QFile>存储文件对象用于后续操作，编写代码后编译失败：

QList<QFile> filesList;

QFile file_1(QString("path/to/file_1"));
QFile file_2(QString("path/to/file_2"));

filesList.append(file_1);
filesList.append(file_2);

for(auto& file : filesList){
    if(!file.open(QIODevice::ReadOnly)){
        qDebug() << "file is not open.";
    }
}

编译报错：

error: ‘QFile::QFile(const QFile&)’ is private within this context
     if (QTypeInfo<T>::isLarge || QTypeInfo<T>::isStatic) n->v = new T(t);
                                                                 ^~~~~~~~

是否适合用QList存储文件列表？ #

QList是Qt中常用的动态容器，本身适合管理对象集合，但不能直接存储QFile实例——因为QFile是不可拷贝类（其拷贝构造函数被声明为private），而QList在添加元素时会尝试拷贝对象，这就触发了编译错误。

如果要管理文件对象集合，QList是合适的容器，但需要调整存储的类型，改用指针或智能指针。

修复方案 #

方案1：使用QList<QFile*>存储原始指针 #

这种方式简单直接，注意对象生命周期即可：

• 如果是栈上创建的QFile对象，确保QList的生命周期不超过这些对象；
• 如果是堆上创建的对象，记得手动清理内存。

栈对象示例：

QList<QFile*> filesList;

QFile file_1(QString("path/to/file_1"));
QFile file_2(QString("path/to/file_2"));

filesList.append(&file_1);
filesList.append(&file_2);

for(auto* file : filesList){
    if(!file->open(QIODevice::ReadOnly)){
        qDebug() << "file is not open.";
    }
}
// file_1和file_2会在栈销毁时自动释放，无需手动清理

堆对象示例（需手动管理内存）：

QList<QFile*> filesList;

filesList.append(new QFile(QString("path/to/file_1")));
filesList.append(new QFile(QString("path/to/file_2")));

for(auto* file : filesList){
    if(!file->open(QIODevice::ReadOnly)){
        qDebug() << "file is not open.";
    }
}

// 使用完后清理内存
qDeleteAll(filesList);
filesList.clear();

方案2：使用智能指针（推荐） #

用std::unique_ptr或QSharedPointer存储，无需手动管理内存，更安全：

#include <memory>

QList<std::unique_ptr<QFile>> filesList;

filesList.append(std::make_unique<QFile>(QString("path/to/file_1")));
filesList.append(std::make_unique<QFile>(QString("path/to/file_2")));

for(auto& file : filesList){
    if(!file->open(QIODevice::ReadOnly)){
        qDebug() << "file is not open.";
    }
}
// 智能指针会在QList销毁时自动释放文件对象

或者使用Qt的QSharedPointer：

QList<QSharedPointer<QFile>> filesList;

filesList.append(QSharedPointer<QFile>::create(QString("path/to/file_1")));
filesList.append(QSharedPointer<QFile>::create(QString("path/to/file_2")));

for(auto& file : filesList){
    if(!file->open(QIODevice::ReadOnly)){
        qDebug() << "file is not open.";
    }
}

内容的提问来源于stack exchange，提问作者A.A.