Rust / 系统课时

用 Cargo 跑通失败示例

用 Cargo 跑通失败示例

这一课先建立一个可重复的失败实验环境:用 Rust 2024 Edition 工程依次触发文件读取失败、整数解析失败和 panic,观察 Cargo 运行时的不同退出路径,为后续讨论 Result、传播和工程边界准备统一基线。

学习目标

  • 创建并确认一个 Rust 2024 Edition 的 Cargo 二进制工程
  • 用同一程序触发文件读取错误、解析错误与主动 panic
  • 从输出中区分“返回错误”与“当前执行路径中断”

创建最小练习工程

先创建独立工程。--edition 2024 会把新 crate 的 edition 明确设为 2024,后续示例都在这个目录中运行。

bash
cargo new rust-error-baseline --edition 2024
cd rust-error-baseline

预期结果

text
目录 <PATH>/rust-error-baseline 已创建,Cargo.toml 中 edition = "2024"

<PATH> 取决于你执行命令时所在的目录,实际值会不同。可以再用下面的命令确认 Cargo 能构建并运行默认程序。

bash
cargo run --quiet

预期输出

text
Hello, world!

写入统一的失败基线

把 src/main.rs 替换为下面的完整程序。正常参数被当作文件路径:程序先读取文本,再解析为 i32;--panic 则专门触发一次主动 panic。

rust
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
        }
    }
}

预期结果

text
程序可以成功编译;传入文件路径时失败通过 Result 返回,传入 --panic 时当前执行路径直接进入 panic。

依次触发三类失败

先传入一个不存在的文件。这里的失败来自 fs::read_to_string,程序仍然能够把错误转换成字符串并返回到 main 处理。

bash
cargo run --quiet -- missing.txt

预期输出

text
error: read missing.txt: <OS_ERROR>

<OS_ERROR> 是操作系统提供的错误文本,例如“文件不存在”,不同平台的具体措辞可能不同。

再准备一个不是整数的文件,触发第二个 Result 失败。

bash
printf 'abc\n' > bad.txt
cargo run --quiet -- bad.txt

预期输出

text
error: parse bad.txt: invalid digit found in string

最后触发主动 panic。

bash
cargo run --quiet -- --panic

预期输出

text
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 的行为,而不必每次重新搭建环境。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Cargo 跑通失败示例

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通