QThread无法二次执行求助：目录文件列表程序运行异常

阿华AIGC实验室

2026-5-12

问题排查与解决方案

核心问题分析

你遇到的问题根源很明确：QThread对象只能被启动一次。你的workerThread是MainWindow的成员变量，第一次点击按钮调用workerThread.start()后，线程执行完任务会进入finished状态，后续再调用start()不会让它重新运行——这就是为什么二次搜索时fileFinder的断点完全没触发的原因。

修复方案：每次创建新的QThread实例

最稳妥的做法是每次点击搜索按钮时，创建一个全新的QThread对象，而不是复用已结束的线程。以下是具体代码修改：

1. 修改`mainwindow.h`

将成员变量QThread workerThread改为指针类型，方便动态创建和销毁：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include "filefinder.h"
#include <QMainWindow>
#include <QThread>

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow {
    Q_OBJECT
public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
private slots:
    void addToTable(QString name);
    void on_btnBrowse_clicked();
private:
    Ui::MainWindow *ui;
    QThread* workerThread; // 改为指针
};
#endif // MAINWINDOW_H

2. 修改`mainwindow.cpp`

调整线程创建、连接和销毁逻辑，确保每次都是新线程：

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QFileDialog>

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow),
    workerThread(nullptr) // 初始化指针为空
{
    ui->setupUi(this);
    // set up tableWidget code here omitted
}

void MainWindow::on_btnBrowse_clicked() {
    // 清空表格
    ui->tableFiles->setRowCount(0);

    // 清理上一次的线程（如果存在）
    if (workerThread) {
        workerThread->quit();
        workerThread->wait();
        delete workerThread;
    }

    fileFinder *finder = new fileFinder;
    workerThread = new QThread; // 创建新线程
    finder->moveToThread(workerThread);

    // 调整连接顺序，避免竞态条件
    connect(finder, SIGNAL(name(QString)), this, SLOT(addToTable(QString)));
    connect(workerThread, SIGNAL(started()), finder, SLOT(run()));
    connect(finder, SIGNAL(finished()), workerThread, SLOT(quit())); // 任务完成后让线程退出
    connect(workerThread, SIGNAL(finished()), finder, SLOT(deleteLater()));
    connect(workerThread, SIGNAL(finished()), workerThread, SLOT(deleteLater())); // 线程自动销毁

    // 获取用户选择的目录
    QString dir = QFileDialog::getExistingDirectory(this, "Select Directory", "/home", QFileDialog::ShowDirsOnly);
    if (dir.isEmpty()) { // 处理用户取消选择的情况
        delete finder;
        delete workerThread;
        workerThread = nullptr;
        return;
    }
    ui->dirEdit->setText(dir);
    finder->setDir(dir);

    // 启动新线程
    workerThread->start();
}

void MainWindow::addToTable(QString name) {
    QTableWidgetItem *fileName = new QTableWidgetItem(name);
    int row = ui->tableFiles->rowCount();
    ui->tableFiles->insertRow(row);
    ui->tableFiles->setItem(row, 0, fileName);
}

MainWindow::~MainWindow() {
    // 销毁剩余线程
    if (workerThread) {
        workerThread->quit();
        workerThread->wait();
        delete workerThread;
    }
    delete ui;
}

3. 完善`fileFinder`类（添加任务完成信号）

为了让线程能正确退出，给fileFinder添加一个finished信号：
修改filefinder.h：

#ifndef FILEFINDER_H
#define FILEFINDER_H
#include <QStringList>
#include <QObject>

class fileFinder : public QObject {
    Q_OBJECT
public:
    fileFinder();
    void searchDir();
    void setDir(QString path);
public slots:
    void run();
signals:
    void name(QString n);
    void finished(); // 添加任务完成信号
private:
    QStringList files;
    QString m_dir;
};
#endif // FILEFINDER_H

修改filefinder.cpp的run()方法：

void fileFinder::run() {
    searchDir();
    foreach(QString f, files){
        emit(name(f));
        usleep(100);
    }
    emit finished(); // 任务完成时发出信号
}