Rust / 系统课时
调用外部进程
调用外部进程
Rust 可以通过 std::process::Command 启动系统命令或其他可执行文件。本课用父进程重新启动当前程序,完整演示参数传递、退出状态判断以及标准输出和错误输出的捕获。
学习目标
- 使用
Command构造并启动外部进程 - 读取退出状态、标准输出和错误输出
- 处理命令不存在、非零退出码和非 UTF-8 输出
使用 output 捕获执行结果
Command::new 接收可执行文件路径,arg 逐个添加参数。调用 output() 后,当前线程会等待子进程结束,并得到 Output,其中包含 status、stdout 和 stderr。
下面的程序不依赖操作系统自带命令。父进程通过 current_exe() 找到自身,再以 --child 参数启动一个独立子进程,因此可以稳定演示成功启动但以非零状态退出的情况。
use std::env;
use std::process::{Command, ExitCode};
fn run_child_mode() -> ExitCode {
println!("child stdout");
eprintln!("child stderr");
// 非零退出码用于模拟外部程序报告失败
ExitCode::from(7)
}
fn main() -> ExitCode {
if env::args().nth(1).as_deref() == Some("--child") {
return run_child_mode();
}
let executable = match env::current_exe() {
Ok(path) => path,
Err(error) => {
eprintln!("无法定位当前可执行文件: {error}");
return ExitCode::from(1);
}
};
let output = match Command::new(executable)
.arg("--child")
.output()
{
Ok(output) => output,
Err(error) => {
eprintln!("无法启动子进程: {error}");
return ExitCode::from(2);
}
};
println!("success={}", output.status.success());
println!("code={:?}", output.status.code());
print!("stdout={}", String::from_utf8_lossy(&output.stdout));
print!("stderr={}", String::from_utf8_lossy(&output.stderr));
ExitCode::SUCCESS
}运行程序:
cargo run --quiet预期输出:
success=false
code=Some(7)
stdout=child stdout
stderr=child stderr正确理解退出状态
进程成功启动不代表命令执行成功。output() 返回 Ok 只说明操作系统成功创建并等待了子进程;业务结果应继续检查 output.status.success()。非零退出码通常表示失败,但具体含义由外部程序定义。
status.code() 返回 Option<i32>。正常退出时通常得到 Some(code);在 Unix 系统中,进程若被信号终止,可能得到 None,因此不要无条件解包。
选择 status、output 或 spawn
只关心退出状态时使用 status()。需要在进程结束后一次性读取标准输出和错误输出时使用 output()。面对长时间运行或输出量很大的程序,应使用 spawn() 获得 Child,再配合管道持续读取,避免把全部内容一次性保存在内存中。
给子进程传值时优先使用多个 arg,并可通过 current_dir、env 或 env_remove 控制其工作目录和环境。不要把不可信输入拼接到 sh -c 或 cmd /C 字符串中,否则容易产生命令注入。
处理输出编码与启动失败
stdout 和 stderr 的类型都是 Vec<u8>,外部程序不保证输出 UTF-8。示例用 String::from_utf8_lossy 便于显示;若输出是二进制协议,应直接处理字节,不要先转成字符串。
当可执行文件不存在、没有执行权限或系统拒绝创建进程时,output() 会返回 io::Error。这类错误与外部程序自己的非零退出码不同,日志中应分别记录“启动失败”和“执行失败”。
本课总结
output()会等待子进程结束,并返回状态、标准输出和错误输出Ok(Output)不等于执行成功,还必须检查status.success()和退出码- 参数应逐个传递,输出按字节处理,不可信内容不要交给命令解释器拼接执行
下一课预告
接下来可以把环境变量、当前目录和外部进程组合起来,构建更可靠的命令行工具执行流程。