C++如何执行系统命令并获取输出结果

在C++开发中，有时候需要在代码里执行一条系统命令，并且读取它的输出结果。这个需求看似简单，但其中的细节和陷阱远比想象中要多。

用 std::system 只能执行命令，拿不到输出

不少刚入门的开发者习惯直接写 std::system("ls -l")，结果发现命令确实执行了，但输出直接打到终端上，程序完全看不到。这是因为 std::system 的核心逻辑是 fork 出一个子进程、exec 执行命令，然后 wait 等待结束——整个过程就像在另一个黑盒里完成，输出没有经过你的程序。想捕获结果，这条路走不通。

推荐方案：用 popen（POSIX）读取 stdout

如果你只是想拿到命令的标准输出，popen 无疑是最顺手的选择。它在 Linux/macOS 上原生支持，Windows 上对应的是 _popen（需要包含 ，行为基本一致）。这个函数返回一个 FILE* 指针，你可以像读普通文件一样逐行读取命令的输出。

有几个关键细节值得留意：

• 单向通信："r" 模式只读 stdout，"w" 模式只写 stdin（后者极少用到）
• 一定要调用 pclose()：不关闭管道的话，子进程会变成僵尸进程，而且资源泄漏无数次
• 处理文本流：输出含换行符，你需要用 fgets 或 fread 自行拼接、截断
• 警惕 shell 注入：命令本身如果包含 $、` 等 shell 元字符，必须做好转义或白名单校验；必要时用 exec 系列代替

下面是一个经典示例：

#include 
#include 
#include 

std::string exec(const char* cmd) {
    FILE* pipe = popen(cmd, "r");
    if (!pipe) return "";
    char buffer[128];
    std::string result;
    while (fgets(buffer, sizeof(buffer), pipe) != nullptr) {
        result += buffer;
    }
    pclose(pipe);
    return result;
}

// 用法：auto out = exec("ps aux | grep myapp");

跨平台更稳的做法：用 fork + pipe + exec

当 popen 不能满足你的需求时——比如要同时捕获 stdout 和 stderr、设置超时、或者完全避开 shell 解析——就需要手动搭建管道了。原理很清楚：创建 pipe、fork 子进程、在子进程里用 dup2 把管道的写端重定向到 STDOUT_FILENO（和 STDERR_FILENO），然后 exec 目标命令。Windows 上对应的做法是 CreateProcess + ReadFile，但实现起来更加繁琐。

几个容易忽略的细节：

• 父进程必须关闭管道的写端，否则 read 永远不会收到 EOF
• 子进程在 exec 之前要完成 fd 重定向（dup2），顺序不能乱
• 记得用 waitpid 获取子进程的退出码，否则进程残留
• C++17 之后可以考虑用 RAII 类封装管道 fd 和生命周期，但标准库目前没有现成工具可用

别踩这些坑

从实际经验来看，最常见的翻车场景包括：

• 字符串生命周期问题：用 std::string::c_str() 传给 popen，但临时对象在 popen 调用前就被销毁了——结果未定义行为。正确的做法是先存为局部 std::string 变量，再取 c_str()
• Windows 下的 cmd 内置命令：dir 这类命令不能直接用，必须写成 "cmd /c dir"；Linux 下 ls 则可以直接用，因为 /bin/sh 默认存在
• 缓冲区太小：只开 16 字节的 buffer，遇到长行直接截断。建议至少 1024 字节，或者用 getline 配合 std::istream 包装
• 忽略执行失败的情况：popen 返回 nullptr 可能意味着 fork/exec 失败（比如命令不存在），而不是输出为空

真正有挑战性的从来不是“怎么调用函数”，而是“怎么安全地拼命令、怎么可靠地收数据、怎么不卡死、怎么在结束后把资源清理干净”。尤其当你需要在多线程环境中使用，fd 管理和信号处理稍不注意就会导致崩溃。理解底层机制，比记几个 API 更重要。