在Qt里用QProcess，很多人前面不是不会启动外部程序，而是程序虽然跑起来了，输出却总是读不全，或者明明子进程已经结束，界面里还是拿不到想要的内容。Qt官方文档把这件事讲得很清楚，QProcess本质上就是一个顺序I/O设备，你可以像读网络连接一样去读子进程的标准输出和标准错误；同时，它又把输出通道、读取信号和阻塞等待分成了几层，所以更稳的做法，应该是先把启动和读取方式分清，再去查为什么“读不到”。

　　一、Qt怎么使用QProcess

　　先不要一上来就把QProcess当成“执行一条命令然后等结果”的黑盒。更稳的用法，是先把程序路径、参数、信号连接和读取方式一起定好，再决定要不要用阻塞等待。Qt官方文档说明，程序可以直接在`start()`里传入，也可以先用`setProgram()`和`setArguments()`设好，再启动；进程启动后会先进入Starting，成功启动后进入Running，并发出`started()`信号。

　　1、先把程序和参数传清楚

　　最常见的写法就是`start(program,arguments)`。如果你不想在一行里写完，也可以先分别调用`setProgram()`和`setArguments()`，再调用`start()`。官方说明里明确写到，这两种方式的效果是一致的。

　　2、启动前先把读取信号接好

　　如果你想实时拿到子进程输出，更适合提前连接`readyReadStandardOutput()`和`readyReadStandardError()`。官方文档说明，这两个信号分别在标准输出和标准错误有新数据时发出，而且不受当前读取通道影响。也就是说，想稳一点，就直接分别接这两个信号，不要只依赖一个总的`readyRead()`。

　　3、读取时优先分开读标准输出和标准错误

　　Qt官方说明，QProcess默认把标准输出和标准错误放在两个独立缓冲区里，也就是`SeparateChannels`。所以你如果想读标准输出，就用`readAllStandardOutput()`；想读标准错误，就用`readAllStandardError()`。这样比单纯用`readAll()`更容易把问题分清。

　　4、需要阻塞等待时再用wait系列函数

　　如果你不是做实时交互，而是想等进程跑完再统一取结果，可以用`waitForStarted()`、`waitForReadyRead()`和`waitForFinished()`。Qt官方同时提醒，这类阻塞函数在主线程里调用时可能会让界面卡住，所以它更适合放在后台线程或短时命令场景里。

　　二、Qt QProcess读不到输出怎么处理

　　读不到输出时，最怕一上来就怀疑QProcess本身坏了。更常见的情况，其实是你读错了通道、子进程把内容写到了标准错误、输出模式改成了转发，或者子进程本身还没真正把缓冲刷出来。Qt官方文档对这些边界写得很清楚，所以排查时最好按通道、模式和时机一层层往下看。

　　1、先确认你读的是标准输出还是标准错误

　　这是最常见的问题。很多命令行工具会把错误、警告甚至部分状态信息写到标准错误，而不是标准输出。Qt官方说明里已经把这两个通道分开定义了，所以如果你只连了`readyReadStandardOutput()`，而程序实际把内容写到`stderr`，你看起来就会像“什么都没读到”。

　　2、再检查通道模式是不是改过

　　如果你在启动前调用了`setProcessChannelMode()`，读取行为会跟默认情况不一样。官方说明，`MergedChannels`会把标准错误并进标准输出，`ForwardedChannels`会把子进程输出直接转发给主进程控制台，而不是继续留在QProcess的内部缓冲里。也就是说，如果你把模式设成了转发，却还在代码里等`readAllStandardOutput()`，结果就可能是空的。

　　3、子进程没有及时刷新输出时不要只怪Qt

　　QProcess只能读到子进程已经写出来的数据。如果子进程自己还在做缓冲，没有换行、没有flush，或者直到结束才统一吐出内容，那你在运行中就可能一直收不到。Qt官方虽然没有把“子进程缓冲”单独列成QProcess参数问题，但它明确说明`waitForReadyRead()`只会在“有新数据可读”时返回，所以前提仍然是子进程真的把数据写进了管道。

　　4、程序路径、环境和工作目录不对时也会表现成“没输出”

　　有些情况不是读不到，而是子进程根本没正常启动。Qt官方文档说明，子进程可以用`setWorkingDirectory()`设置工作目录，也可以用`setProcessEnvironment()`设置环境变量；在Windows上，`PATH`和`SystemRoot`这类环境变量又会直接影响子进程能不能正常找到依赖。路径或环境一旦不对，外部程序可能直接失败，看起来就会像“没有任何输出”。

　　三、Qt QProcess输出排查先看哪里

　　真正容易把人绕进去的，不是不会写QProcess，而是顺序反了。明明程序都没正常启动，却一直在改读取信号；明明内容写到了标准错误，却只盯着标准输出。更稳的排查顺序，应该是先看进程有没有正常起来，再看内容落在哪个通道，最后才去看是不是时机和缓冲问题。这样查，通常会比一上来就反复换读取函数更有效。

　　1、第一步先看进程状态和错误信号

　　先确认QProcess有没有从Starting进入Running，再看有没有触发`errorOccurred()`。Qt官方文档已经说明，启动失败、运行出错都会通过状态和错误类型反映出来，所以这一步能先排掉“程序根本没跑起来”的情况。

　　2、第二步再看输出到底落在哪个通道

　　把标准输出和标准错误分别接起来，必要时两边都读一次。这样最容易判断问题是“没有输出”，还是“输出去了别的地方”。官方文档对这两个通道和对应信号的定义已经非常明确，这一步通常最值钱。

　　3、第三步最后再看等待方式和缓冲时机

　　当你已经确认程序能正常启动，通道也没读错，再去看是不是阻塞等待放错了线程，或者子进程输出本来就比较晚。Qt官方已经提醒，`waitForReadyRead()`和`waitForFinished()`这类函数只是等待数据或结束事件，不会替你解决子进程本身不刷输出的问题。

　　4、如果是GUI程序，再特别留意转发模式

　　官方文档明确提醒，在GUI应用里直接用`ForwardedChannels`通常不是好主意，因为输出会被直接转发而不是留在内部缓冲里。也就是说，如果你的主程序本身就是图形界面，最好还是自己读取并显示结果，而不是把通道直接转发出去。

　　总结

　　QProcess这件事，真正难的往往不是“怎么启动一个程序”，而是“启动以后到底该从哪里拿结果”。如果程序没起来，问题通常在路径、环境、工作目录或启动本身；如果程序起来了但没读到，优先就该去分清标准输出和标准错误；如果通道也没错，再回头看是不是转发模式、等待方式或子进程缓冲把时机拖晚了。把这几层顺序理清以后，QProcess读输出这件事通常不会再只剩一句“为什么没有数据”，而会变成一条比较容易收住的排查线。