thiserror 是一個 Rust 庫，用于簡化錯誤處理并使錯誤類型更易于使用和維護。它通過自動生成實現 std::error::Error 和 std::fmt::Display trait 的代碼，從而減少了手動編寫這些代碼的工作量。thiserror 還提供了一些有用的功能，如錯誤鏈（error chaining）和自定義錯誤類型。
在 Rust 中，錯誤傳播通常是通過返回 Result 類型來實現的。當你在函數中遇到錯誤時，你可以使用 Err 變體返回一個錯誤，并在調用該函數的代碼中處理錯誤。這種模式可能會導致大量的錯誤檢查和處理代碼，而且很難跟蹤錯誤的來源。
thiserror 通過以下方式改進了錯誤傳播：
自動生成錯誤實現：thiserror 自動為你的錯誤類型生成實現了 std::error::Error 和 std::fmt::Display trait 的代碼，這樣你就不需要手動編寫這些代碼了。這可以減少代碼重復，并提高代碼的可讀性和可維護性。
錯誤鏈：thiserror 支持錯誤鏈，允許你在錯誤中包含有關錯誤來源的信息。這有助于更好地理解錯誤的根源，并簡化錯誤處理。要使用錯誤鏈，你可以在定義錯誤類型時包含一個 Error 枚舉，并為每個變體指定一個錯誤消息。然后，你可以使用 ? 操作符將錯誤傳播給調用者。
自定義錯誤類型：thiserror 允許你輕松地創建自定義錯誤類型，以滿足你的特定需求。你可以通過實現 thiserror::Error trait 來定義自己的錯誤類型，并使用 thiserror! 宏來生成錯誤類型的代碼。
下面是一個使用 thiserror 的示例：
use thiserror::Error;
#[derive(Error, Debug)]
pub enum MyError {
#[error("An IO error occurred: {0}")]
IoError(#[from] std::io::Error),
#[error("A custom error occurred: {0}")]
CustomError(String),
}
fn read_file() -> Result<String, MyError> {
let content = std::fs::read_to_string("file.txt")?;
Ok(content)
}
fn main() {
match read_file() {
Ok(content) => println!("File content: {}", content),
Err(e) => eprintln!("Error: {}", e),
}
}
在這個示例中，我們定義了一個名為 MyError 的自定義錯誤類型，它包含了兩個變體：IoError 和 CustomError。我們使用 #[from] 屬性指示 IoError 可以從 std::io::Error 類型自動轉換而來。然后，我們在 read_file 函數中使用 ? 操作符將錯誤傳播給調用者。最后，我們在 main 函數中處理錯誤。
