tiny-process-library：C++ 跨平台进程管理库实战指南

构造函数第一个参数是命令，第二个是工作目录（. 表示当前目录）。返回 0 通常代表成功。

异步执行 + 捕获输出

这是最常用的场景。不阻塞主线程，通过回调函数实时接收子进程的 stdout 和 stderr 输出。不过要注意，回调是在子线程中执行的，如果操作全局变量记得加锁。

#include "process.hpp"
#include <iostream>
#include <string>

int main() {
    std::string output, error;

#ifdef _WIN32
    TinyProcessLib::Process process(
        "cmd /c dir",
        ".",
        [&output](const char* data, size_t size) { output.append(data, size); },
        [&error](const char* data, size_t size) { error.append(data, size); }
    );
#else
    TinyProcessLib::Process process(
        "ls -l",
        ".",
        [&output](const char* data, size_t size) { output.append(data, size); },
        [&error](const char* data, size_t size) { error.append(data, size); }
    );
#endif

    // 非阻塞检查进程是否结束
    while (!process.try_get_exit_status()) {
        std::cout << "进程还在运行..." << std::endl;
        // 避免循环过快，休眠一下
#ifdef _WIN32
        Sleep(500);
#else
        usleep(500000);
#endif
    }

    std::cout << "=== 标准输出 ===\n" << output << std::endl;
    std::cout << "=== 错误输出 ===\n" << error << std::endl;
    return 0;
}

这里用到了 try_get_exit_status() 轮询，比 wait() 更灵活，主线程可以在等待期间做其他事情。

终止子进程

有时候进程卡死了，或者你只想跑几秒就关掉它，可以用 kill() 方法。

#include "process.hpp"
#include <iostream>
#include <chrono>
#include <thread>

int main() {
#ifdef _WIN32
    TinyProcessLib::Process process("cmd /c ping -n 10 127.0.0.1", ".");
#else
    TinyProcessLib::Process process("ping -c 10 127.0.0.1", ".");
#endif

    // 运行 3 秒后强制终止
    std::this_thread::sleep_for(std::chrono::seconds(3));
    std::cout << "终止子进程..." << std::endl;
    process.kill();

    // 终止后仍需调用 get_exit_status() 释放资源
    int exit_code = process.get_exit_status();
    std::cout << "进程退出码：" << exit_code << std::endl;
    return 0;
}

Windows 下对应 TerminateProcess，Linux/macOS 下发送 SIGKILL。别忘了解除引用后再析构对象。

设置环境变量

给子进程传递自定义环境，比如配置路径或密钥。

#include "process.hpp"
#include <vector>
#include <string>

int main() {
    // KEY=VALUE 格式
    std::vector<std::string> env = {"MY_VAR=hello_tiny_process", "PATH=/usr/bin"};

#ifdef _WIN32
    TinyProcessLib::Process process(
        "cmd /c echo %MY_VAR%",
        ".",
        [](const char* data, size_t size) {
            std::cout << "输出：" << std::string(data, size) << std::endl;
        },
        nullptr,
        env
    );
#else
    TinyProcessLib::Process process(
        "echo $MY_VAR",
        ".",
        [](const char* data, size_t size) {
            std::cout << "输出：" << std::string(data, size) << std::endl;
        },
        nullptr,
        env
    );
#endif
    process.get_exit_status();
    return 0;
}

注意 Windows 读取环境变量用 %VAR%，Linux/macOS 用 $VAR。

跨平台注意事项

• 命令格式：Windows 普通命令通常要包一层 cmd /c，Linux/macOS 直接执行即可。
• 路径分隔符：Windows 用反斜杠，Unix 系用正斜杠。建议统一使用 std::filesystem 处理路径，避免硬编码。
• 编码问题：Windows 默认 GBK，Linux/macOS 是 UTF-8。如果在 Windows 下捕获中文输出乱码，可以尝试 chcp 65001 切换代码页。

常见问题排查

• 进程创建失败：先确认命令是否存在（比如 Windows 下有没有 ping.exe），再检查工作目录是否有效。
• 回调不触发：确保进程有实际输出，且主线程没有过早退出导致进程被销毁。
• 死锁风险：异步模式下，如果回调里调用了阻塞 IO，可能会卡住子线程，尽量保持回调轻量。

总结

tiny-process-library 的核心就是那个 Process 类。它把复杂的跨平台进程调用封装成了简单的接口，支持同步/异步执行、输出捕获、进程终止和环境变量设置。开发时记得用条件编译区分不同系统的命令语法，异步回调要注意线程安全。有了它，跨平台调用外部工具就没那么头疼了。