Qt文件复制禁用缓冲：解决SSD到HDD复制进度条卡顿问题

阿华AIGC实验室

2026-5-26

解决Qt文件复制进度条卡顿（SSD读速远快于HDD写速）的方案

这问题我之前做Qt本地文件备份工具时踩过一模一样的坑！本质就是读写速度不匹配导致进度更新的依据和实际完成进度脱节，给你几个亲测有效的解决思路：

核心思路：把进度更新锚定到「实际写入完成」而非「读取完成」

你现在的进度条应该是按已读取的字节数来更新的——SSD读得飞快，瞬间把缓冲区塞满，此时读取暂停、进度条停滞；等HDD慢慢写完一部分缓冲区数据，读取又开始猛冲，进度条就会突然跳动。把进度更新改成基于成功写入HDD的字节数，就能让进度条完全跟着HDD的写入速度平稳走。

具体实现步骤（Qt示例）

拆分读写逻辑到线程（避免阻塞UI）
把文件读取和写入分别放到独立的工作线程里，用信号槽传递数据和进度：
- 读取线程负责从SSD读数据块，发送给写入线程
- 写入线程负责把数据块写到HDD，每写完一块就发送「已写入X字节」的信号
- 主线程收到信号后更新进度条

关键代码片段
写入工作线程的核心逻辑：

#include <QThread>
#include <QFile>

class WriteWorker : public QObject
{
    Q_OBJECT
public:
    explicit WriteWorker(const QString& targetPath, QObject *parent = nullptr) 
        : m_targetFile(targetPath) {}

    bool openTargetFile() {
        return m_targetFile.open(QIODevice::WriteOnly | QIODevice::Truncate);
    }

public slots:
    void writeChunk(const QByteArray& chunk) {
        if (!m_targetFile.isOpen()) return;
        
        qint64 bytesWritten = m_targetFile.write(chunk);
        if (bytesWritten == -1) {
            emit errorOccurred(m_targetFile.errorString());
            return;
        }
        // 发送已写入字节数的信号
        emit bytesWrittenUpdated(bytesWritten);
    }

    void finishWriting() {
        m_targetFile.flush();
        m_targetFile.close();
        emit writingFinished();
    }

signals:
    void bytesWrittenUpdated(qint64 bytes);
    void errorOccurred(const QString& msg);
    void writingFinished();

private:
    QFile m_targetFile;
};

主线程里连接信号更新进度条：

// 初始化进度条和总文件大小
qint64 totalFileSize = sourceFile.size();
qint64 totalWritten = 0;
ui->progressBar->setRange(0, 100);

// 连接写入线程的进度信号
connect(writeWorker, &WriteWorker::bytesWrittenUpdated, this, [this, &totalWritten, totalFileSize](qint64 bytes) {
    totalWritten += bytes;
    int progress = static_cast<int>((totalWritten * 100LL) / totalFileSize);
    ui->progressBar->setValue(progress);
    // 强制更新UI（避免Qt事件循环延迟）
    qApp->processEvents();
});