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,因此每个 ? 都会在失败时立即返回错误,而不是直接崩溃。
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(())
}预期输出
文件内容:
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 遍历目录内容。