Rust / 系统课时
实现核心流程
实现核心流程
本课把一个最小文本处理工具串起来:读取文件、逐行迭代、过滤数据、汇总结果,并用 Result 与 ? 把 I/O 错误向上传播。最终得到一条可运行、可验证且便于扩展的核心处理链路。
学习目标
- 用
BufReader和lines逐行读取文本文件 - 用迭代器完成过滤和计数,避免手写多余状态
- 用
Result与?传播文件读取错误,并在程序入口统一处理
明确核心处理链路
这个工具只做一件事:统计文本文件中长度达到阈值的非空行。核心函数不负责创建文件、不打印日志,只接收路径和配置并返回结果,因此测试和复用都更简单。
处理顺序是“打开文件 → 建立缓冲读取器 → 收集各行 → 过滤空行和短行 → 汇总数量”。其中任何一次读取失败都会通过 ? 立刻返回,不再继续执行后续过滤。

组合文件读取与迭代器
BufReader 避免频繁直接访问文件,lines() 则把输入转换成逐行迭代器。下面示例为了可以直接运行,会先写入一个临时文本文件,再调用核心函数读取并统计;真实工具中只需要把路径换成用户传入的文件即可。
use std::fs::{self, File};
use std::io::{self, BufRead, BufReader};
#[derive(Debug)]
struct Config {
ignore_blank: bool,
min_len: usize,
}
#[derive(Debug)]
struct ProcessResult {
matched: usize,
total: usize,
}
#[derive(Debug)]
enum AppError {
Io(io::Error),
}
impl From<io::Error> for AppError {
fn from(error: io::Error) -> Self {
Self::Io(error)
}
}
fn process_file(path: &str, config: &Config) -> Result<ProcessResult, AppError> {
let file = File::open(path)?;
let reader = BufReader::new(file);
// 先把每一行的 I/O 结果收集起来;任意一行读取失败都会提前返回。
let lines = reader.lines().collect::<Result<Vec<_>, _>>()?;
let total = lines.len();
// 过滤逻辑保持为纯迭代器链,避免额外维护计数状态。
let matched = lines
.into_iter()
.map(|line| line.trim().to_string())
.filter(|line| !config.ignore_blank || !line.is_empty())
.filter(|line| line.len() >= config.min_len)
.count();
Ok(ProcessResult { matched, total })
}
fn run() -> Result<(), AppError> {
let path = "sample.txt";
fs::write(path, "Rust\nfast\n\nzero-copy\n")?;
let config = Config {
ignore_blank: true,
min_len: 5,
};
let result = process_file(path, &config)?;
println!("total = {}", result.total);
println!("matched = {}", result.matched);
fs::remove_file(path)?;
Ok(())
}
fn main() {
if let Err(error) = run() {
eprintln!("error: {error:?}");
std::process::exit(1);
}
}预期输出
total = 4
matched = 1这里一共有 4 行输入,空行会被忽略;Rust 和 fast 长度小于 5,只有 zero-copy 满足条件,因此 matched 为 1。
理解问号运算符的边界
File::open(path)?、收集各行时的 ?、以及 fs::remove_file(path)? 都遵循同一规则:成功时取出内部值继续执行,失败时把错误转换为当前函数的错误类型并立即返回。前提是存在合适的 From 转换,因此示例实现了 From<io::Error> for AppError。
保持核心逻辑可测试
process_file 不解析命令行,也不直接退出进程,它只返回 Result<ProcessResult, AppError>。这种边界让调用方可以决定失败后是打印错误、重试还是转换成其他状态,同时让核心函数保持单一职责。
如果后续要增加不同命令,可以在入口先匹配 Command,再把路径和配置交给对应处理函数。文件读取、迭代器过滤和错误传播仍可以保持不变,扩展点集中在命令分派和具体业务规则上。