Rust / 系统课时

读写文本文件

读写文本文件

本课用 Rust 标准库完成文本文件的创建、覆盖、追加和读取,并把错误交给调用方处理。学完后,你可以写出一个可直接运行的文件读写程序,也能判断何时应改用字节接口。

学习目标

  • 掌握 fs::read_to_string、fs::write 和 OpenOptions 的用途
  • 完成文本文件的覆盖写入、追加写入与读取验证
  • 识别 UTF-8、相对路径和文件截断等常见边界

选择合适的文件接口

Rust 的 std::fs 提供了适合一次性操作的便捷函数。文件较小、希望一次读入内存时,优先使用这些接口;需要持续写入、追加或精细控制打开方式时,再使用 File 或 OpenOptions。

需求 推荐接口 关键行为
读取整个 UTF-8 文本 fs::read_to_string 返回 String,非 UTF-8 内容会报错
创建或覆盖文本 fs::write 文件不存在则创建,存在则清空后写入
追加文本 OpenOptions 需要启用 append(true),通常同时启用 create(true)
读取原始字节 fs::read 返回 Vec<u8>,不要求内容是 UTF-8

完成覆盖、追加和读取

下面的程序先覆盖写入 notes.txt,再追加一行,最后读取完整内容。main 返回 Result,因此每个 ? 都会在失败时立即返回错误,而不是直接崩溃。

rust
use std::error::Error;
use std::fs::{self, OpenOptions};
use std::io::Write;

fn main() -> Result<(), Box<dyn Error>> {
    let path = "notes.txt";

    // fs::write 会创建文件;文件已存在时会先清空旧内容。
    fs::write(path, "Rust 文件操作\n")?;

    // append(true) 保证新内容写到末尾,create(true) 允许首次运行时创建文件。
    let mut file = OpenOptions::new()
        .create(true)
        .append(true)
        .open(path)?;
    file.write_all("追加一行\n".as_bytes())?;

    let content = fs::read_to_string(path)?;
    println!("文件内容:\n{content}");

    Ok(())
}

预期输出

text
文件内容:
Rust 文件操作
追加一行

运行后,当前工作目录中会出现 notes.txt。实际文件位置取决于启动程序时的工作目录,而不一定是源代码所在目录。

理解覆盖与追加的边界

fs::write 和 File::create 都采用覆盖语义:文件已存在时,原内容会被截断。需要保留旧内容时,不能先调用这两个接口,而应直接使用启用了 append(true) 的 OpenOptions。

read_to_string 只适用于合法 UTF-8 文本。若文件可能包含图片、压缩数据或其他二进制内容,应改用 fs::read;若文件很大,应使用 BufReader 分块读取,避免一次占用过多内存。

常见错误与检查方法

相对路径按照程序的当前工作目录解析。找不到文件时,先打印或检查启动目录,再确认路径是否正确。追加文件时若遗漏 create(true),目标文件不存在就会打开失败;若误用 write(true) 配合截断选项,则可能覆盖旧内容。

生产代码不建议对文件操作直接使用 unwrap()。继续使用 Result 和 ?,可以让上层统一记录错误、重试或向用户返回明确提示。

本课总结

  • fs::write 适合创建或覆盖小型文本,OpenOptions 适合追加和精细控制
  • fs::read_to_string 要求文件内容是 UTF-8,二进制数据应使用字节接口
  • 相对路径由当前工作目录决定,覆盖与追加语义必须明确区分

下一课预告

下一课将使用 Path 和 PathBuf 构建跨平台路径,并通过 read_dir 遍历目录内容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读写文本文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通