快捷導(dǎo)航

Rust 錯誤處理的黃金搭檔(thiserror和anyhow)

更新時間：2026年06月17日 10:04:25 作者：Rust研習(xí)社

本文主要介紹了Rust 錯誤處理的黃金搭檔(thiserror和anyhow),文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

在 Rust 開發(fā)中，錯誤處理是不可或缺的核心環(huán)節(jié)，但手動實現(xiàn)錯誤相關(guān) trait 往往會產(chǎn)生大量的樣板代碼。而為了解決這些樣板代碼，那就不得不提到兩個主流的 Rust 錯誤處理庫 thiserror 和 anyhow 了，現(xiàn)在，我們一起來看看它們解決了什么樣的問題。

簡化自定義錯誤

在其他語言中，自定義錯誤非常簡單，以 Go 為例，只需要實現(xiàn) error 接口即可：

import "fmt"

type NotFoundError struct {
    Resource string
}

func (e NotFoundError) Error() string {
    return fmt.Sprintf("%s not found", e.Resource)
}

而在 Rust 中，自定義錯誤就比較麻煩了，需要手動實現(xiàn) Error、Display 和 Debug 這三個特征。如果需要支持錯誤自動轉(zhuǎn)換，即適配 ? 操作符，還需要額外實現(xiàn) From 特征：

use std::error::Error;
use std::{fmt, io, num::ParseIntError};

#[derive(Debug)]
enum MyError {
    Io(io::Error),
    Parse(ParseIntError),
    Custom(String),
}

// 實現(xiàn) Display 特征
impl fmt::Display for MyError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            MyError::Io(e) => write!(f, "IO 錯誤: {}", e),
            MyError::Parse(e) => write!(f, "解析錯誤: {}", e),
            MyError::Custom(s) => write!(f, "自定義錯誤: {}", s),
        }
    }
}

// 實現(xiàn) Error 特征，標(biāo)記該類型為錯誤類型
impl Error for MyError {}

// 實現(xiàn) From 特征，支持錯誤自動轉(zhuǎn)換
impl From<io::Error> for MyError {
    fn from(e: io::Error) -> Self {
        MyError::Io(e)
    }
}

impl From<ParseIntError> for MyError {
    fn from(e: ParseIntError) -> Self {
        MyError::Parse(e)
    }
}

可以看到，僅是定義一個簡單的自定義錯誤枚舉，就需要編寫大量的樣板代碼。而 thiserror 庫則通過宏解決了這一問題。它能在編譯期自動生成上述所有樣板代碼，讓我們專注于錯誤本身的定義。

我們用 thiserror 來改寫上面的示例，實現(xiàn)如下：

use std::{io, num::ParseIntError};
use thiserror::Error;

#[derive(Error, Debug)] 
enum MyError {
    // 定義 Display 輸出格式，{0} 引用變體第一個字段
    #[error("IO 錯誤: {0}")]
    // #[from] 自動實現(xiàn) From 特征
    Io(#[from] io::Error),

    #[error("解析錯誤: {0}")]
    Parse(#[from] ParseIntError),

    #[error("自定義錯誤: {0}")]
    Custom(String),
}

需要注意的是，thiserror 是基于宏實現(xiàn)，所有代碼生成都在編譯期完成，運行時零開銷，不會對程序性能帶來影響。因此，在需要自定義錯誤類型的場景中，可以大膽的使用 thiserror。

簡化通用錯誤處理

在實際開發(fā)中，我們常常會遇到函數(shù)返回多種不同錯誤類型的場景。此時有兩種處理思路：一是定義全局自定義錯誤枚舉，也就是上一章節(jié)的方案，可以通過 thiserror 簡化。二是使用 Box<dyn Error> 作為錯誤返回類型，無需單獨定義錯誤枚舉。

use std::error::Error;
use std::fs;

fn read_and_parse(path: &str) -> Result<i32, Box<dyn Error>> {
    let content = fs::read_to_string(path)?;
    let num: i32 = content.trim().parse()?;
    Ok(num)
}

先簡單了解下 Box<dyn Error>，由于所有的錯誤類型都實現(xiàn) Error 特征，dyn Error 作為動態(tài)派發(fā)的特征對象，所以可以兼容所有錯誤類型。

然而由于 dyn Error 是不定長類型（DST），無法直接存儲在棧上，因此需要用 Box<T> 智能指針將其分配到堆上。

最后是標(biāo)準(zhǔn)庫中已為所有實現(xiàn) Error 特征的類型實現(xiàn)了 From 轉(zhuǎn)換，因此可以直接使用 ? 操作符自動轉(zhuǎn)換錯誤類型。標(biāo)準(zhǔn)庫實現(xiàn)大致如下：

impl<E: Error + 'static> From<E> for Box<dyn Error> {
    fn from(err: E) -> Self {
        Box::new(err)
    }
}

搞懂了 Box<dyn Error> 后，現(xiàn)在我們就可以講 anyhow 了，anyhow 的底層實現(xiàn)是：

Box<dyn Error + Send + Sync + 'static>

不難看出，anyhow 是 Box<dyn Error> 的增強版，具體如下：

簡潔的類型別名

anyhow 提供 anyhow::Result<T> 類型別名，簡化代碼：

use anyhow::Result;

fn main() -> Result<()> {
    Ok(())
}

攜帶業(yè)務(wù)上下文

anyhow 內(nèi)置的 context 和 with_context 方法，它們?yōu)殄e誤添加上下文：

use anyhow::{Context, Result};
use std::fs;

fn read_and_parse(path: &str) -> Result<i32> {
    let content = fs::read_to_string(path)?;
    let num: i32 = content.trim().parse()?;
    Ok(num)
}

fn main() -> anyhow::Result<()> {
    let content = fs::read_to_string("config.json")
        .context("讀取配置文件失敗")?;
    
    println!("{}", content);
    
    Ok(())
}

// Output:
// Error: 讀取配置文件失敗

// Caused by:
//     No such file or directory (os error 2)

支持多線程與異步

Box<dyn Error> 未約束 Send + Sync，所以在多線程或異步場景下時會直接報錯。而 anyhow 強制約束了 Send + Sync，開箱即用，完全兼容多線程與異步場景：

use std::thread;

fn do_work() -> anyhow::Result<()> {
    Err(anyhow::anyhow!("something wrong"))
}

fn main() {
    let handle = thread::spawn(|| do_work());

    let result = handle.join().unwrap();

    match result {
        Ok(_) => println!("success"),
        Err(e) => println!("error: {:#}", e),
    }
}

// Output:
// error: something wrong