QT5使用QProcess读取外部进程标准输出返回0长度的解决方法

你遇到的read()返回长度为0的问题是两个跨平台通用机制共同导致的，和Qt版本、操作系统无关：

• 第一，QProcess的IO事件依赖Qt事件循环调度。你启动进程后直接同步循环调用read()，既没有启动事件循环，也没有调用waitForReadyRead()主动等待管道数据就绪，QProcess不会主动从内核管道中拉取子进程输出的数据，自然读不到有效内容。
• 第二，子进程stdout默认缓冲机制问题。当进程的stdout没有连接到交互式终端（比如被QProcess重定向到匿名管道）时，操作系统默认给stdout开块缓冲：写入的内容会先存在子进程自己的内存缓冲区里，攒到缓冲区大小（通常4KB~8KB）或者进程退出时才会真正写入管道，除非子进程主动调用刷新接口。如果你的bsptrans只是每次输出小的进度数字、没有手动刷新缓冲区，数据会一直卡在子进程侧，父进程永远读不到。

两部分配置缺一不可：

1. 子进程侧修改 #

每次向stdout写入进度后必须强制刷新缓冲区，否则数据不会发出：

• 如果是C语言实现：写完进度后调用fflush(stdout);
• 如果是C++实现：写完进度后加std::cout << std::flush;
• 一劳永逸的配置：子进程启动时直接设置stdout为行缓冲，遇到换行符自动刷新，Linux/Windows通用：

// 放在子进程main函数最开头即可
setvbuf(stdout, NULL, _IOLBF, 0);

2. Qt侧实现 #

UI场景下禁止用同步阻塞循环读，会导致界面卡死，必须用Qt原生的信号槽异步机制读取数据，和QProgressBar联动的参考实现如下：

#include <QMainWindow>
#include <QProcess>
#include <QProgressBar>
#include <QByteArray>

class ProgressDemo : public QMainWindow
{
    Q_OBJECT
public:
    ProgressDemo(QWidget *parent = nullptr) : QMainWindow(parent)
    {
        // 初始化进度条
        m_progressBar = new QProgressBar(this);
        m_progressBar->setRange(0, 100);
        setCentralWidget(m_progressBar);

        // 初始化进程对象
        m_process = new QProcess(this);
        m_process->setProgram("/home/weber/exp/qt5/build_bsptrans/bsptrans");

        // 绑定输出可读信号：子进程有数据到达时自动触发
        connect(m_process, &QProcess::readyReadStandardOutput, this, [this](){
            const QByteArray output = m_process->readAllStandardOutput().trimmed();
            bool parseOk = false;
            const int progress = output.toInt(&parseOk);
            if (parseOk && progress >= 0 && progress <= 100) {
                m_progressBar->setValue(progress);
            }
        });

        // 绑定进程结束信号做收尾
        connect(m_process, QOverload<int, QProcess::ExitStatus>::of(&QProcess::finished),
                this, [this](int exitCode, QProcess::ExitStatus){
            m_progressBar->setValue(100);
        });

        // 启动进程
        m_process->start();
        if (!m_process->waitForStarted(3000)) {
            // 在这里添加启动失败的处理逻辑
        }
    }

private:
    QProcess* m_process = nullptr;
    QProgressBar* m_progressBar = nullptr;
};

如果只是做功能验证写临时测试代码，可以用同步等待接口，每次读之前主动等待数据就绪，注意不要在UI主线程用这种写法：

// 测试用同步逻辑片段
if (proc.waitForStarted()) {
    char buffer[128];
    for (int i=0; i<10; i++) {
        // 最多等1秒，直到有数据可读
        if (!proc.waitForReadyRead(1000)) break;
        qint64 len = proc.read(buffer, 128);
        if (len > 0) {
            qDebug() << "读到数据长度：" << len;
        }
    }
}

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