在 Rust 1.x 中读写文件：事实上的方法

Rust 与文件：神话、恐惧与事实上的方法

您是否曾问过自己：“在现代 Rust 中，到底应该如何正确地读写文件？” 如果是，您并不孤单。在 Stack Overflow 上，问题 “在 Rust 1.x 中读写文件的事实上的方法是什么？” 已获得数千次浏览和数十个回答。这是社区真正的痛点，尤其是对于那些来自 Python 或 JavaScript 的开发者，在这些语言中 open() 和 read() 是基础操作，而在 Rust 中却需要处理所有权、借用以及大量 trait。

在本文中，我们将详细梳理 Rust 1.x 中所有主要的文件操作方法：从“简单地将所有内容读入字符串”到高效地逐行读取大型日志文件。您将了解哪种方法被认为是惯用的，哪种方法最好留待特殊情况使用。我们开始吧！

1. std::fs：标准工具集

std::fs 模块是您的第一站。它提供了用于读取、写入、复制和删除文件的函数。Rust 1.x 稳定了便捷的封装，隐藏了大部分底层系统调用操作。

将整个文件读入字符串

最简单的方法是使用 std::fs::read_to_string。它打开文件，将其全部读入内存，并返回 Result<String>。非常适合小型配置文件或文本文件。

use std::fs;

fn main() -> std::io::Result<()> {    let content = fs::read_to_string("hello.txt")?;    println!("文件内容为:{}", content);    Ok(())}

对于简单情况，这种方法实际上是标准做法。它简洁、安全，并使用 ? 进行错误处理。唯一的缺点是整个文件会被加载到内存中，因此不适用于 GB 级别的日志文件。

读取到字节向量

如果您处理的是二进制数据（如图像、压缩包），请使用 std::fs::read。它返回 Vec<u8>。

use std::fs;

fn main() -> std::io::Result<()> {    let bytes = fs::read("image.png")?;    println!("已读取 {} 字节", bytes.len());    Ok(())}

写入文件

对于写入操作，请使用 std::fs::write。它接受路径和数据（字符串或字节数组），并创建/覆盖文件。

use std::fs;

fn main() -> std::io::Result<()> {    fs::write("output.txt", "Hello, Rust!")?;    Ok(())}

简单得就像一加一。但如果您需要追加到文件末尾而不是覆盖，则必须使用 OpenOptions。

2. BufReader 和 BufWriter：当大小很重要时

对于大文件或频繁的 I/O 操作，缓冲包装器可以派上用场。它们减少了系统调用的次数，这对性能至关重要。

使用 BufReader 逐行读取

经典示例是逐行读取大型日志文件：

use std::fs::File;use std::io::{BufRead, BufReader};

fn main() -> std::io::Result<()> {    let file = File::open("large_log.txt")?;    let reader = BufReader::new(file);

    for line in reader.lines() {        let line = line?;        println!("{}", line);    }    Ok(())}

lines() 方法返回一个行迭代器，其中每一行都是一个 Result<String>。请注意循环内的 line?——这是对每一行读取错误的处理。

重要提示： lines() 会移除换行符。如果您需要保留它们，请使用 read_until 或将文件读取为 Vec<u8>。

使用 BufWriter 写入

在写入大量数据时，缓冲也很有用：

use std::fs::File;use std::io::{BufWriter, Write};

fn main() -> std::io::Result<