Rust中如何从std::io错误获取含文件名的有效提示？

当调用fs::read_to_string这类IO操作时，标准库返回的错误默认不包含目标文件名，而这正是很多场景下需要的关键信息。以下是两种惯用的解决方式：

1. 标准库map_err手动包装（无额外依赖） #

利用Result的map_err方法捕获原始IO错误，创建包含文件名的新错误，同时保留原错误的类型（ErrorKind）以便后续处理：

use std::fs;
use std::io::{self, Error, ErrorKind};

fn read_to_string(file_name: &str) -> io::Result<String> {
    fs::read_to_string(file_name).map_err(|err| {
        Error::new(
            err.kind(),
            format!("Failed to read file '{}': {}", file_name, err),
        )
    })
}

返回的错误信息会变成类似：

Os { code: 2, kind: NotFound, message: "Failed to read file 'nonexistent.txt': No such file or directory" }

这种方式无需额外依赖，适合简单场景或不想引入第三方库的情况。

2. 使用thiserror crate（优雅的自定义错误） #

如果项目需要处理多种错误类型，thiserror是Rust生态中自定义错误的常用工具，能更简洁地定义带上下文的错误：

首先在Cargo.toml添加依赖：

[dependencies]
thiserror = "1.0"

然后定义包含文件名的自定义错误类型：

use std::fs;
use std::io;
use thiserror::Error;

#[derive(Error, Debug)]
enum FileReadError {
    #[error("Failed to read file '{file}': {source}")]
    Io {
        file: String,
        #[source]
        source: io::Error,
    },
}

fn read_to_string(file_name: &str) -> Result<String, FileReadError> {
    fs::read_to_string(file_name)
        .map_err(|source| FileReadError::Io {
            file: file_name.to_string(),
            source,
        })
}

这种方式的优势在于：

• 错误信息格式通过宏自动生成，无需手动拼接字符串
• #[source]保留了原始IO错误的上下文，可通过source()方法获取底层错误
• 自定义错误类型更清晰，调用者能明确匹配错误类型

为什么不推荐用expect #

注释中的expect方式虽然能输出含文件名的信息，但它会直接触发panic，中断程序执行。在遍历文件系统这类场景中，我们通常希望跳过错误文件继续处理，而非直接崩溃，因此返回包含上下文的错误结果才是符合Rust错误处理哲学的正确方式。

内容的提问来源于stack exchange，提问作者Konstantin Kazartsev