最近在 Debian 上写 Rust 代码，经常会被问到错误处理怎么做。今天把一些核心思路和坑点整理出来，希望能帮你少走弯路。
核心原则与类型
先说几个关键判断。
用类型系统表达可恢复错误：这是 Rust 的硬核特长。优先用 Result 表示可能失败的操作，用 Option 表示可能缺失的值。别想着用“错误码”或“异常”那一套，Rust 的类型系统能让你在编译时就消灭一大半问题。
统一错误类型与传播：为模块或应用定义一个统一的 AppError，然后为外部错误实现 From 转换。配合 ? 操作符，错误传播会变得非常清爽。只在顶层（比如 main 函数或 HTTP 入口）把错误转换成用户能看懂的信息——日志、退出码、或者一个友好的错误页面。
区分可恢复与不可恢复：业务预期内的失败，比如文件不存在、网络超时，返回 Result。程序无法继续的致命错误，比如某个永远不该发生的分支或者不变式被打破，再使用 panic!。这个分寸感很重要，需要根据场景来拿捏。
错误可见与可调试：为你的错误类型实现 std::error::Error，提供 source() 和 backtrace() 方法。上下文信息越完整，定位问题就越轻松——文件、行号、操作名，能保留的都保留。
在 Debian 环境下的实践清单
Debian 作为开发环境，有几个必须注意的点。
- 开发环境：用
rustup管理工具链，配合cargo构建与测试。保持工具链和依赖更新，可以避免很多因版本不匹配导致的奇怪错误。 - 系统依赖与链接器：安装
build-essential，它提供cc链接器。如果用到数据库或 SSL，记得装对应的-dev包——libssl-dev、libsqlite3-dev、libpq-dev这些都是常客。如果遇到 "linker 'cc' not found" 或者外部库链接失败，十有八九是这里没配好。 - 构建与诊断：碰到链接或编译问题，先试试
cargo clean，然后cargo build --release验证。缺失库就按 Debian 的包名对应安装-dev版本，再重试。
代码组织与模式
- 自定义错误与自动转换：推荐用
thiserror这个 crate 来定义枚举型错误，它能自动派生Errortrait。为常见的外部错误实现From转换，配合?就能实现统一的错误传播。 - 错误组合与转换：在
Result链中用map和and_then做值转换和短路组合。需要添加上下文信息时用Result::map_err，注意别把源错误丢掉了。 - 顶层错误呈现：在 main 函数或命令入口处，把
AppError转换成用户能看懂的提示和合适的退出码。库代码中尽量返回错误，而不是直接打印或 panic。 - 日志与诊断：用结构化日志输出错误和关键上下文。需要的时候启用 backtrace，定位问题会快很多。
最小可运行示例
看个简单示例就明白了，核心是用标准库和 thiserror 实现统一传播与顶层呈现。
// Cargo.toml
// [dependencies]
// thiserror = "1.0"
use std::fs::File;
use std::io::{self, Read};
use thiserror::Error;
#[derive(Debug, Error)]
enum AppError {
#[error("I/O error: {0}")]
Io(#[from] io::Error),
#[error("Parse error: {0}")]
Parse(#[from] std::num::ParseIntError),
}
fn read_and_parse(path: &str) -> Result {
let mut s = String::new();
File::open(path)?.read_to_string(&mut s)?;
// ? 自动转换为 AppError::Io
let n: i32 = s.trim().parse()?;
// ? 自动转换为 AppError::Parse
Ok(n)
}
fn main() {
match read_and_parse("number.txt") {
Ok(n) => println!("Parsed: {}", n),
Err(e) => {
eprintln!("Error: {}", e);
std::process::exit(1);
}
}
}
关键点：函数签名显式返回 Result，外部错误通过 From 自动注入统一错误类型，顶层负责呈现和退出码。这才是 Rust 错误处理的精髓所在。
常见错误场景与排查要点
- 构建时报错 linker 'cc' not found：安装
build-essential就能解决，它会提供 gcc 和 cc。 - 链接数据库/SSL 失败：安装对应的
-dev包，比如libpq-dev、libsqlite3-dev、libssl-dev。确保头文件和相关库都可用。 - 依赖或工具链过旧：用
rustup update更新工具链，必要时调整Cargo.toml中的依赖版本。
