QProcess 是 Qt 中调用外部命令行程序的唯一推荐方式；它支持异步、信号通知、输出捕获和跨平台路径/参数处理，优于 system() 和 popen()。
QProcess 是 Qt 中调用外部命令行程序的唯一推荐方式——system() 会卡死界面，popen() 不跨平台且难控错误，而 QProcess 天然支持异步、信号通知、输出捕获和跨平台路径/参数处理。
直接执行简单命令（如 ls、ping）
适合单次、无交互、不需要实时响应的场景，比如启动一个工具后等它结束。
-
start()接收两个参数：程序名（"ping"）和参数列表（QStringList() ），不经过 shell 解析，最安全 - 必须调用
waitForFinished()才能读到输出，否则readAllStandardOutput()返回空 - Linux/macOS 下命令名不用带
.sh或.exe；Windows 下如果没加扩展名，系统会按PATHEXT自动补（但建议显式写"notepad.exe"） - 错误码要检查：
process.exitCode()是子进程返回值，process.error()是启动失败原因（如QProcess::FailedToStart）
QProcess proc;
proc.start("ping", QStringList() << "127.0.0.1" << "-c" << "1");
if (proc.waitForFinished(5000)) {
QByteArray out = proc.readAllStandardOutput();
qDebug() << "stdout:" << out;
if (proc.exitCode() != 0) {
qDebug() << "ping failed with code" << proc.exitCode();
}
}执行带管道/重定向/多条命令的 shell 行为（如 bash -c）
当你需要 ls | grep .txt、cd /tmp && touch a.txt 或变量展开时，必须走 shell 解释器。
- Linux/macOS：启动
"bash"，参数用-c+ 完整命令字符串，例如：proc.start("bash", QStringList() - Windows：启动
"cmd"，参数用/c，例如：proc.start("cmd", QStringList() - 别用
write()往bash进程里发命令——除非你真在做交互式终端。绝大多数情况，一条-c就够了 - 注意编码：Windows 控制台默认是 GBK，
readAllStandardOutput()返回的是本地编码字节，要用QString::fromLocal8Bit()转，而不是fromUtf8()
异步执行 + 实时读取输出（避免界面卡死）
界面程序不能用 waitForFinished() 阻塞主线程，得靠信号驱动。
- 连接
readyReadStandardOutput信号，在槽函数里调readAllStandardOutput()拿增量数据（不是全部） - 同样要连
readyReadStandardError，stderr 不一定和 stdout 同时到达，尤其错误信息可能早于 stdout - 进程结束信号是
finished(int, QProcess::ExitStatus)，不是stateChanged；此时才能安全调exitCode() - 记得在构造
QProcess时传父对象（如this），否则可能内存泄漏或信号断连
<pre class="brush:php;toolbar:false;">QProcess *proc = new QProcess(this);
connect(proc, &QProcess::readyReadStandardOutput, [=]() {
qDebug() << "got stdout chunk:" << proc->readAllStandardOutput();
});
connect(proc, &QProcess::finished, [=](int code, QProcess::ExitStatus status) {
qDebug() << "process finished, exit code =" << code;
proc->deleteLater(); // 清理
});
proc->start("find", QStringList() << "/usr" << "-name" << "*.h" << "-print0");常见坑与绕过方案
这些点不踩一次很难意识到，但改起来往往就一行代码。
start("ls -l") ❌：这会尝试执行名为 <code>"ls -l"的程序（不存在）。正确写法是start("ls", QStringList() 或走 <code>bash -c- 工作目录不对：默认继承父进程目录，用
proc.setWorkingDirectory("/tmp")显式设置 - 环境变量缺失：比如找不到
python3，用proc.environment()获取当前环境，再append("PATH=...")补全 - 中文路径/参数乱码：Windows 上确保源文件保存为 UTF-8 with BOM，或统一用
QString::fromStdWString()构造参数 - 子进程残留：若主程序崩溃，
start()启动的子进程默认随父退出；但startDetached()启动的不会——慎用，且无法获取输出
真正麻烦的从来不是“怎么启动”，而是“怎么知道它干了什么、干没干完、哪错了”。把 error()、exitCode()、readAllStandardError() 这三者串起来看，比只盯着 stdout 有用十倍。
