将错误重定向到标准错误

目前，我们使用 println! 宏将所有输出写入终端。在大多数终端中，有两种输出：用于一般信息的标准输出（stdout）和用于错误消息的标准错误（stderr）。这种区别使用户能够选择将程序的成功输出定向到文件，同时仍然将错误消息打印到屏幕上。

println! 宏只能打印到标准输出，所以我们必须使用其他东西来打印到标准错误。

检查错误被写入何处

首先，让我们观察 minigrep 打印的内容当前是如何被写入标准输出的，包括任何我们想要改为写入标准错误的错误消息。我们将通过将标准输出流重定向到一个文件，同时故意引发错误来做到这一点。我们不会重定向标准错误流，所以任何发送到标准错误的内容将继续显示在屏幕上。

命令行程序应该将错误消息发送到标准错误流，这样即使我们将标准输出流重定向到文件，仍然可以在屏幕上看到错误消息。我们的程序目前行为不佳：我们即将看到它将错误消息输出保存到了文件中！

为了演示这种行为，我们将使用 > 和我们想要将标准输出流重定向到的文件路径 output.txt 来运行程序。我们不会传递任何参数，这应该会导致错误：

$ cargo run > output.txt

> 语法告诉 shell 将标准输出的内容写入 output.txt 而不是屏幕。我们没有看到预期的错误消息打印到屏幕上，所以这意味着它一定最终进了文件。这就是 output.txt 包含的内容：

Problem parsing arguments: not enough arguments

是的，我们的错误消息被打印到了标准输出。将这样的错误消息打印到标准错误会更有用，这样只有成功运行的数据才会最终进入文件。我们将改变这一点。

将错误打印到标准错误

我们将使用列表 12-24 中的代码来改变错误消息的打印方式。由于我们在本章前面做的重构，所有打印错误消息的代码都在一个函数 main 中。标准库提供了 eprintln! 宏，它打印到标准错误流，所以让我们把之前调用 println! 打印错误的两个地方改为使用 eprintln!。

文件名：src/main.rs

use std::env;
use std::error::Error;
use std::fs;
use std::process;

use minigrep::{search, search_case_insensitive};

fn main() {
    let args: Vec<String> = env::args().collect();

    let config = Config::build(&args).unwrap_or_else(|err| {
        eprintln!("Problem parsing arguments: {err}");
        process::exit(1);
    });

    if let Err(e) = run(config) {
        eprintln!("Application error: {e}");
        process::exit(1);
    }
}

pub struct Config {
    pub query: String,
    pub file_path: String,
    pub ignore_case: bool,
}

impl Config {
    fn build(args: &[String]) -> Result<Config, &'static str> {
        if args.len() < 3 {
            return Err("not enough arguments");
        }

        let query = args[1].clone();
        let file_path = args[2].clone();

        let ignore_case = env::var("IGNORE_CASE").is_ok();

        Ok(Config {
            query,
            file_path,
            ignore_case,
        })
    }
}

fn run(config: Config) -> Result<(), Box<dyn Error>> {
    let contents = fs::read_to_string(config.file_path)?;

    let results = if config.ignore_case {
        search_case_insensitive(&config.query, &contents)
    } else {
        search(&config.query, &contents)
    };

    for line in results {
        println!("{line}");
    }

    Ok(())
}

列表 12-24：使用 eprintln! 将错误消息写入标准错误而不是标准输出

现在让我们以同样的方式再次运行程序，不带任何参数，并用 > 重定向标准输出：

$ cargo run > output.txt
Problem parsing arguments: not enough arguments

现在我们在屏幕上看到了错误，而 output.txt 不包含任何内容，这正是我们期望命令行程序具有的行为。

让我们再次运行程序，这次使用不会导致错误的参数，但仍然将标准输出重定向到文件，如下所示：

$ cargo run -- to poem.txt > output.txt

我们不会看到任何终端输出，而 output.txt 将包含我们的结果：

文件名：output.txt

Are you nobody, too?
How dreary to be somebody!

这演示了我们现在适当地将标准输出用于成功输出，将标准错误用于错误输出。

总结

本章回顾了到目前为止你学到的一些主要概念，并介绍了如何在 Rust 中执行常见的 I/O 操作。通过使用命令行参数、文件、环境变量以及用于打印错误的 eprintln! 宏，你现在已经准备好编写命令行应用程序了。结合前几章的概念，你的代码将组织良好、将数据有效地存储在适当的数据结构中、妥善处理错误，并且经过充分测试。

接下来，我们将探索一些受函数式语言影响的 Rust 特性：闭包和迭代器。

键盘快捷键

Rust 程序设计语言