为何Rust编译器不允许在Result中直接使用自定义错误类型？

我正在跟着一个YouTube指南构建Rust项目结构。我创建了error.rs文件存放自定义错误，代码如下：

#[derive(thiserror::Error, Debug)]
pub enum Error {
    /// 初始阶段使用，代码成熟后移除。
    #[error("Generic error: {0}")]
    Generic(String),
}

之后我在prelude.rs中重导出该错误：

// 重导出 crate 的 Error。
pub use crate::error::Error;

// 将 Result 别名化为 crate 的 Result。
pub type Result<T> = core::result::Result<T, Error>;

// 用于 newtype 模式的通用包装元组结构体，
// 主要用于外部类型间的 From/TryFrom 转换
pub struct W<T>(pub T);

接着我编写了一个使用该错误的函数：

fn foo(n: i32) -> Result<i32> {
    if n == 3 {
        return Error::Generic("I don't like 3".to_string());
    }
    Ok(n)
}

但尝试使用自定义错误时，Rust不允许，提示我需要将其包裹在Err值中。为何返回Result时不能直接使用自定义错误？有没有办法在这种情况下避免包裹？

报错信息如下：

error[E0308]: mismatched types
  --> src/lib.rs:12:16
   |
10 | fn foo(n: i32) -> Result<i32> {
   |                   ----------- 因返回类型，预期为 `std::result::Result<i32, error::Error>`
11 |     if n == 3 {
12 |         return Error::Generic("I don't like 3".to_string());
   |                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 预期 `Result<i32, Error>`，找到 `Error`
   |
   = note: 预期枚举 `std::result::Result<i32, error::Error>`
              找到枚举 `error::Error`
help: 尝试将表达式包裹在 `Err` 中
   |
12 |         return Err(Error::Generic("I don't like 3".to_string()));
   |                ++++                                            +

补充：视频作者通过以下代码解决了类似问题：

use crate::prelude::*;
use std::fs::DirEntry;

impl TryFrom<W<&DirEntry>> for String {
    type Error = Error;
    fn try_from(val: W<&DirEntry>) -> Result<String> {
        val.0
            .path()
            .to_str()
            .map(String::from)
            .ok_or_else(|| Error::Generic(format!("Invalid path {:?}", val.0)))
    }
}

为什么不能直接返回自定义错误？ #

你的Result<T>是core::result::Result<T, Error>的别名，而Result本身是一个枚举，只有Ok(T)和Err(E)两个变体。你直接返回Error::Generic(...)时，本质是返回了Error类型的实例，但函数要求返回的是Result<i32>（也就是Result<i32, Error>），两者类型完全不匹配，所以Rust会抛出类型不匹配的错误。

有没有办法避免手动包裹Err？ #

有几种实用的方式可以简化这个过程：

1. 给自定义错误加辅助方法
   你可以在Error枚举上实现一个辅助方法，自动把错误变体包装成Err：

   impl Error {
       // 用于返回 Result<T> 的通用错误方法
       pub fn err<T>(msg: impl Into<String>) -> Result<T> {
           Err(Self::Generic(msg.into()))
       }
   }
   

   这样在函数里就能直接用：

   fn foo(n: i32) -> Result<i32> {
       if n == 3 {
           return Error::err("I don't like 3");
       }
       Ok(n)
   }
   

2. 自定义宏
   写一个简单的宏来自动包裹错误：

   macro_rules! err {
       ($err:expr) => {
           Err($err)
       };
   }
   

   使用时只需要：

   fn foo(n: i32) -> Result<i32> {
       if n == 3 {
           return err!(Error::Generic("I don't like 3".to_string()));
       }
       Ok(n)
   }
   

3. 结合?操作符（针对转换场景）
   如果你的自定义错误实现了From trait来兼容其他错误类型，那么可以用?自动将其他错误转换并包装成Err。但这个方法只适用于处理已有错误的场景，不适用于直接创建自定义错误返回的情况。

视频作者的代码为什么不需要手动包裹？ #

看作者的代码，ok_or_else方法的返回值本身就是Result<T, E>类型——当Option是None时，它会调用闭包生成Error实例，然后自动包装成Err。所以整个表达式的结果正好匹配函数的返回类型，自然不需要额外手动包裹Err。而你的场景是直接创建错误实例返回，没有借助这类能生成Result的方法，所以必须手动用Err包裹。

内容的提问来源于stack exchange，提问作者João Areias