Rust / 系统课时
用 Cargo 跑通失败示例
用 Cargo 跑通失败示例
这一课先建立一个可重复的失败实验环境:用 Rust 2024 Edition 工程依次触发文件读取失败、整数解析失败和 panic,观察 Cargo 运行时的不同退出路径,为后续讨论 Result、传播和工程边界准备统一基线。
学习目标
- 创建并确认一个 Rust 2024 Edition 的 Cargo 二进制工程
- 用同一程序触发文件读取错误、解析错误与主动 panic
- 从输出中区分“返回错误”与“当前执行路径中断”
创建最小练习工程
先创建独立工程。--edition 2024 会把新 crate 的 edition 明确设为 2024,后续示例都在这个目录中运行。
cargo new rust-error-baseline --edition 2024
cd rust-error-baseline预期结果
目录 <PATH>/rust-error-baseline 已创建,Cargo.toml 中 edition = "2024"<PATH> 取决于你执行命令时所在的目录,实际值会不同。可以再用下面的命令确认 Cargo 能构建并运行默认程序。
cargo run --quiet预期输出
Hello, world!写入统一的失败基线
把 src/main.rs 替换为下面的完整程序。正常参数被当作文件路径:程序先读取文本,再解析为 i32;--panic 则专门触发一次主动 panic。
use std::env;
use std::fs;
use std::process::ExitCode;
fn read_number(path: &str) -> Result<i32, String> {
// 文件读取和整数解析都保留为可返回给调用者的失败。
let text = fs::read_to_string(path)
.map_err(|err| format!("read {path}: {err}"))?;
text.trim()
.parse::<i32>()
.map_err(|err| format!("parse {path}: {err}"))
}
fn main() -> ExitCode {
let mut args = env::args().skip(1);
match args.next().as_deref() {
// 这条分支只用于建立不可恢复失败的观察基线。
Some("--panic") => panic!("deliberate baseline panic"),
Some(path) => match read_number(path) {
Ok(value) => {
println!("number={value}");
ExitCode::SUCCESS
}
Err(err) => {
eprintln!("error: {err}");
ExitCode::FAILURE
}
},
None => {
eprintln!("usage: cargo run -- <file>|--panic");
ExitCode::FAILURE
}
}
}预期结果
程序可以成功编译;传入文件路径时失败通过 Result 返回,传入 --panic 时当前执行路径直接进入 panic。依次触发三类失败
先传入一个不存在的文件。这里的失败来自 fs::read_to_string,程序仍然能够把错误转换成字符串并返回到 main 处理。
cargo run --quiet -- missing.txt预期输出
error: read missing.txt: <OS_ERROR><OS_ERROR> 是操作系统提供的错误文本,例如“文件不存在”,不同平台的具体措辞可能不同。
再准备一个不是整数的文件,触发第二个 Result 失败。
printf 'abc\n' > bad.txt
cargo run --quiet -- bad.txt预期输出
error: parse bad.txt: invalid digit found in string最后触发主动 panic。
cargo run --quiet -- --panic预期输出
thread 'main' panicked at <PATH>/src/main.rs:<LINE>:<COLUMN>:
deliberate baseline panic
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace<PATH>、<LINE> 和 <COLUMN> 会随本地目录与源码行号变化。关键观察点不是具体位置,而是前两类失败进入了 Result 分支,panic 则没有返回普通错误值。
把输出变成后续判断基线
文件不存在和解析失败都属于“调用者仍可能处理”的情况:可以换路径、提示用户、使用默认值或重试,因此适合继续沿 Result 传播。主动 panic 则直接终止当前正常控制流,通常用于表示程序不变量被破坏或当前路径无法继续安全执行。
后续实验只需在这个工程中替换局部代码,就能持续比较 Result、?、自定义错误和 panic 的行为,而不必每次重新搭建环境。