Learn Rust Coding · 课时

错误转换

Q: 「错误转换」这节课中我会学到什么？

From 实现 你通过在浏览器中直接运行的动手代码来练习 Learn Rust Coding，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

From 实现

错误转换 是 CoddyKit 上的免费 Learn Rust Coding 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Learn Rust Coding 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Learn Rust Coding 课程共包含 4 节课。

为什么要转换错误？

代码的不同层会产生不同的错误类型。要通过同一个函数传播这些错误，您需要将低层错误转换为统一类型。Rust 通过 From trait 实现这一点。

From Trait

From<T> 定义了如何根据一种类型构建另一种类型。为您的错误类型实现它后，就可以将源错误转换为该类型。

trait From<T> {
    fn from(value: T) -> Self;
}

? 如何使用 From

当您编写 expr?，且错误类型与函数返回的错误类型不同时，运算符会调用 From::from 进行转换。这就是错误能够无缝传播的原理。

统一的错误类型

定义一个枚举，用来容纳函数可能产生的每种错误。

#[derive(Debug)]
enum AppError {
    Io(std::io::Error),
    Parse(std::num::ParseIntError),
}

实现 From

为每种源错误编写一个 From impl，将其转换为对应的变体。

impl From<std::io::Error> for AppError {
    fn from(e: std::io::Error) -> Self {
        AppError::Io(e)
    }
}

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

自动传播

完成这些 impl 后，? 就会自动将每个错误转换为 AppError。

fn read_count(path: &str) -> Result<i32, AppError> {
    let text = std::fs::read_to_string(path)?; // io::Error -> AppError
    let n: i32 = text.trim().parse()?;          // ParseIntError -> AppError
    Ok(n)
}

Into 是它的镜像

实现 From<A> for B 会自动为您提供 A: Into<B>。建议实现 From；这样可以免费获得 into()。

fn make() -> AppError {
    let e: std::io::Error = std::io::Error::other("boom");
    e.into() // uses From<io::Error> for AppError
}

装箱 Trait 对象

对于快速转换，Box<dyn Error> 可以接受任何错误类型，因为标准库提供了将错误转换为它的通用 From impl。

use std::error::Error;

fn run() -> Result<(), Box<dyn Error>> {
    let n: i32 = "42".parse()?; // ParseIntError -> Box<dyn Error>
    println!("{n}");
    Ok(())
}

生成 From 的软件包

手动编写每个 From impl 很繁琐。thiserror 的 #[from] 注解会为您生成它们，而 anyhow 会自动将所有错误转换为一种类型。

选择方案

转换策略总结：

手动实现 From — 完全可控，但代码更多
thiserror #[from] — 带类型的错误，自动生成 impl
Box<dyn Error> 或 anyhow — 所需样板代码最少

在转换过程中添加上下文

From impl 不仅可以封装错误，还可以丰富错误信息。这里的转换会附加额外上下文，让最终错误更有说明性。

impl From<std::num::ParseIntError> for AppError {
    fn from(e: std::num::ParseIntError) -> Self {
        // could log or annotate here before wrapping
        AppError::Parse(e)
    }
}

快速检查

? 运算符使用哪个 trait 将一种错误类型转换为另一种？

回顾

您已经学习了错误转换：

? 通过 From trait 转换错误
为您的错误枚举实现 From<Source>
From 会免费为您提供 Into 和 into()
Box<dyn Error> 可以接受任何错误
thiserror 和 anyhow 会自动处理样板代码

常见问题解答

「错误转换」课时是免费的吗？

是的 — 「错误转换」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Learn Rust Coding 课程的其余内容，请升级到 CoddyKit PRO。 Learn Rust Coding 课程共包含 4 节课。

「错误转换」这节课中我会学到什么？

From 实现你通过在浏览器中直接运行的动手代码来练习 Learn Rust Coding，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Learn Rust Coding 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Learn Rust Coding 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「错误转换」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Learn Rust Coding 课中编写并运行代码吗？

能。每节 Learn Rust Coding 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Learn Rust Coding