QT项目实战（二）：核心功能实现、数据持久化、多线程任务处理、界面交互优化

好，咱们接着上一章的项目骨架继续往下搭。上一章我们把界面架子、信号槽骨架都铺好了，这一章要往里填真正的血肉——核心功能、数据怎么存、耗时任务怎么不卡界面、以及交互细节怎么打磨到顺手。

说实话，很多初学者做项目，功能跑通了就觉得完事了。但在我眼里，一个项目能不能拿得出手，恰恰取决于这些“看不见”的部分——数据会不会丢？界面会不会卡？操作顺不顺手？

咱们一个一个来啃。

一、核心功能实现：把业务逻辑写扎实

先说说核心功能。以我们正在做的这个项目为例（假设是一个任务管理器），核心功能无非就是：增、删、改、查。

但你别小看这四个字。我在项目中见过太多人把“增删改查”写得一团乱麻——业务逻辑和界面代码搅在一起，改一个需求要动七八个文件。

我个人习惯的做法是：把核心业务逻辑封装成一个独立的类，比如 TaskManager，界面只管调用它的接口，不关心内部怎么实现。

// taskmanager.h
class TaskManager : public QObject {
    Q_OBJECT
public:
    explicit TaskManager(QObject *parent = nullptr);

    // 核心操作接口
    bool addTask(const TaskData &task);
    bool removeTask(int taskId);
    bool updateTask(int taskId, const TaskData &newData);
    QList<TaskData> getAllTasks() const;
    TaskData getTaskById(int taskId) const;

signals:
    void taskAdded(int taskId);
    void taskRemoved(int taskId);
    void taskUpdated(int taskId);
    void dataChanged();

private:
    QList<TaskData> m_tasks;
    int m_nextId = 1;
};

你看，界面那边只需要 connect 这些信号，数据一变，界面自动刷新。这样后期维护起来，脑子不用切换上下文。

二、数据持久化：别让用户白干一场

功能跑通了，但一关程序数据全没了——这谁受得了？数据持久化是必须的。

QT 里做持久化，常用的方案有几种：

• QSettings：适合存配置，不适合存大量业务数据
• JSON 文件：轻量、可读性好，适合中小型项目
• SQLite：适合结构化数据、需要查询的场景

我个人建议：中小项目用 JSON，数据量大或查询复杂用 SQLite。我们这个项目用 JSON 就够。

// 保存到 JSON 文件
bool TaskManager::saveToFile(const QString &filePath) {
    QJsonArray arr;
    for (const auto &task : m_tasks) {
        QJsonObject obj;
        obj["id"] = task.id;
        obj["title"] = task.title;
        obj["description"] = task.description;
        obj["completed"] = task.completed;
        arr.append(obj);
    }

    QJsonDocument doc(arr);
    QFile file(filePath);
    if (!file.open(QIODevice::WriteOnly)) {
        qWarning() << "无法写入文件:" << filePath;
        return false;
    }
    file.write(doc.toJson());
    file.close();
    return true;
}

// 从 JSON 文件加载
bool TaskManager::loadFromFile(const QString &filePath) {
    QFile file(filePath);
    if (!file.open(QIODevice::ReadOnly)) {
        qWarning() << "无法读取文件:" << filePath;
        return false;
    }

    QByteArray data = file.readAll();
    file.close();

    QJsonDocument doc = QJsonDocument::fromJson(data);
    if (!doc.isArray()) return false;

    m_tasks.clear();
    QJsonArray arr = doc.array();
    for (const auto &val : arr) {
        QJsonObject obj = val.toObject();
        TaskData task;
        task.id = obj["id"].toInt();
        task.title = obj["title"].toString();
        task.description = obj["description"].toString();
        task.completed = obj["completed"].toBool();
        m_tasks.append(task);
    }
    return true;
}

三、多线程任务处理：别让界面“冻住”

你有没有遇到过这种情况：点了个按钮，界面卡死好几秒，鼠标都动不了？

原因很简单——耗时操作（比如大量计算、网络请求、文件读写）跑在主线程里，QT 的事件循环被阻塞了，界面自然就“冻”住了。

解决办法：把耗时任务扔到子线程里去。

QT 里做多线程，我推荐用 QThread + 信号槽的方式，而不是继承 QThread 重写 run()。为什么？因为前者更符合 QT 的设计哲学——任务和线程分离。

// 耗时任务对象
class ExportWorker : public QObject {
    Q_OBJECT
public:
    explicit ExportWorker(const QList<TaskData> &tasks, QObject *parent = nullptr);

public slots:
    void doWork();  // 在这个槽里执行耗时操作

signals:
    void progress(int percent);
    void finished(bool success, const QString &message);

private:
    QList<TaskData> m_tasks;
};

// 使用方式
void MainWindow::onExportClicked() {
    // 创建线程和 worker
    QThread *thread = new QThread(this);
    ExportWorker *worker = new ExportWorker(m_manager->getAllTasks());
    worker->moveToThread(thread);

    // 连接信号槽
    connect(thread, &QThread::started, worker, &ExportWorker::doWork);
    connect(worker, &ExportWorker::finished, this, &MainWindow::onExportFinished);
    connect(worker, &ExportWorker::finished, thread, &QThread::quit);
    connect(thread, &QThread::finished, worker, &QObject::deleteLater);

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

你看，界面该刷新刷新，该响应用户操作就响应，后台默默干活。用户体验一下子就上来了。

四、界面交互优化：细节决定成败

功能都有了，数据也存了，界面也不卡了。但用户用起来还是觉得“差点意思”——为什么？

因为交互细节没到位。

我总结几个常用的优化点：

• 操作反馈：用户点了按钮，至少给个状态变化（比如按钮禁用、显示“保存中...”）
• 加载状态：数据加载时显示进度条或转圈动画，别让用户干等
• 输入校验：用户输错了，当场提示，别等提交了才报错
• 快捷键支持：Ctrl+S 保存、Ctrl+Z 撤销，老用户会觉得很贴心
• 撤销/重做：这个比较复杂，但一旦做出来，用户粘性直接拉满

举个例子，给保存按钮加个状态反馈：

void MainWindow::onSaveClicked() {
    ui->btnSave->setEnabled(false);
    ui->btnSave->setText("保存中...");

    // 这里执行保存操作
    bool ok = m_manager->saveToFile(m_currentFilePath);

    if (ok) {
        statusBar()->showMessage("保存成功", 3000);
    } else {
        statusBar()->showMessage("保存失败，请重试", 5000);
    }

    ui->btnSave->setEnabled(true);
    ui->btnSave->setText("保存");
}

你看，就多了几行代码，但用户感知到的“安全感”完全不一样。

五、知识体系总览

这一章的内容比较多，我画了张图帮你理清脉络：

六、避坑指南 & 个人经验

最后，分享几个我这些年积累的经验：

• 数据持久化一定要做版本兼容：我吃过一次亏——项目迭代了几版，旧数据格式和新代码不兼容，用户升级后数据全丢了。从那以后，我每次改数据格式都会加一个 version 字段。
• 多线程调试很痛苦：建议先在单线程下把逻辑调通，再拆到子线程里。否则你根本分不清是逻辑 bug 还是线程竞争问题。
• 交互优化不要一次做太多：先做最影响体验的那几个（比如保存反馈、加载状态），其他的可以慢慢迭代。一口吃不成胖子。
• 记得加日志：不管是文件操作还是线程任务，关键步骤都打一行 qDebug() 或写入日志文件。线上出问题的时候，日志就是你的救命稻草。

嗯，这一章的内容就到这里。代码量不大，但每一点都是实战中会反复遇到的。你把这些基础打牢了，后面做复杂功能的时候会轻松很多。

---

公众号:蓝海资料掘金营，微信deep3321