从 panic 到 Result：用 Rust 重新整理一个 ping 项目的错误处理

> 一个能跑的程序和一个不会崩的程序之间，差了一套像样的错误处理。

适用版本：Rust 1.85+ · thiserror 2.x · anyhow 1.x · 2026-06-21

---

〇、先搭环境：Cargo.toml

> 以下所有代码均可编译运行，不再是伪代码。先创建项目：

cargo new ping-rs && cd ping-rs

# Cargo.toml
[package]
name = "ping-rs"
version = "0.1.0"
edition = "2021"

[dependencies]
thiserror = "2"
anyhow = "1"

---

一、反面教材：能跑但一碰就碎

假设你写了一个简单的 ping 工具——发 ICMP，等回复，打 RTT。初版大概长这样：

use std::net::{IpAddr, ToSocketAddrs};
use std::process::Command;

fn main() {
    let args: Vec = std::env::args().collect();

    // 💥 参数不足 → 索引越界 panic
    let target = &args[1];

    let ip = resolve(target);
    let rtt = ping(ip);
    println!("{}: rtt={:.2}ms", target, rtt);
}

fn resolve(host: &str) -> IpAddr {
    let addr = (host, 0)
        .to_socket_addrs()
        .unwrap()                         // 💥 DNS 查询失败 → panic
        .next()
        .unwrap()                         // 💥 没有地址返回 → panic
        .ip();
    addr
}

fn ping(ip: IpAddr) -> f64 {
    let output = Command::new("ping")
        .arg("-c")
        .arg("1")
        .arg(ip.to_string())
        .output()
        .unwrap();                        // 💥 ping 命令不存在 → panic

    if !output.status.success() {
        panic!("ping failed");            // 💥 网络不通 → panic（无上下文）
    }

    let stdout = String::from_utf8(output.stdout)
        .unwrap();                        // 💥 非 UTF-8 输出 → panic

    parse_rtt(&stdout).unwrap()           // 💥 输出格式变化 → panic
}

fn parse_rtt(s: &str) -> Option {
    s.lines()
        .find(|l| l.contains("time="))?
        .split("time=")
        .nth(1)?
        .split_whitespace()
        .next()?
        .replace("ms", "")
        .parse()
        .ok()                             // 💥 解析失败静默吞掉
}

---

二、问题在哪

问题	表现	后果
unwrap() 到处用	任意一步失败 → panic	程序崩溃，无恢复机会
错误信息不可读	thread 'main' panicked at src/main.rs:15:10	用户看到一行谜语
错误类型丢失	Option 把失败原因吞了	不知道是网络不通还是解析失败