Rust / 系统课时
设计数据模型
设计数据模型
一个小型 Rust 工具如果先把配置、命令、成功结果和失败状态建模清楚,后续流程会明显更简单。本课用结构体承载稳定字段,用枚举表达互斥分支,让类型本身约束程序可以出现的状态。
学习目标
- 用结构体表达配置和处理结果等“字段固定”的数据
- 用枚举表达命令变体和错误状态等“互斥选择”
- 通过类型边界减少无效组合,并为后续错误传播准备统一接口
先按职责拆开数据
配置描述“程序如何工作”,命令参数描述“这次要做什么”,处理结果描述“做完得到了什么”。三者虽然都可能包含数字或字符串,但生命周期和职责不同,最好不要塞进同一个大结构体。
例如,Config 可以保存最小长度、是否忽略空行等稳定选项;Command 用不同变体表示统计或预览;ProcessResult 只保存业务结果。这样函数签名能直接说明自己依赖哪类数据,也更容易单独测试。

用枚举消除无效组合
如果把所有命令参数都放进一个结构体,统计命令可能被迫携带只属于预览命令的 lines 字段。枚举可以把每种命令所需字段绑定在对应变体上,因此不存在“命令是 Count,但又带着 Preview 专属参数”的无效状态。
错误也适合用枚举。I/O 失败和参数非法的来源、处理方式不同,把它们区分成不同变体后,上层既可以统一返回 AppError,也可以在需要时精确匹配具体错误。
建立最小可运行模型
下面的程序只演示数据模型,不负责真正解析命令行。它创建配置、命令、成功结果和错误值,并通过 Debug 输出确认每个类型保存的数据。
#![allow(dead_code)]
#[derive(Debug, Clone)]
struct Config {
ignore_blank: bool,
min_len: usize,
}
#[derive(Debug)]
enum Command {
Count { path: String },
Preview { path: String, lines: usize },
}
#[derive(Debug)]
struct ProcessResult {
matched: usize,
total: usize,
}
#[derive(Debug)]
enum AppError {
Io(std::io::Error),
InvalidArgument(String),
}
impl From<std::io::Error> for AppError {
fn from(error: std::io::Error) -> Self {
Self::Io(error)
}
}
fn main() {
let config = Config {
ignore_blank: true,
min_len: 3,
};
let command = Command::Count {
path: "input.txt".to_string(),
};
let result = ProcessResult {
matched: 7,
total: 10,
};
let error = AppError::InvalidArgument(
"min_len must be greater than 0".to_string(),
);
println!("config = {config:?}");
println!("command = {command:?}");
println!("result = {result:?}");
println!("error = {error:?}");
}预期输出
config = Config { ignore_blank: true, min_len: 3 }
command = Count { path: "input.txt" }
result = ProcessResult { matched: 7, total: 10 }
error = InvalidArgument("min_len must be greater than 0")实际编译器版本可能影响警告文本,但上面的标准输出保持一致。
给后续流程留出稳定边界
真正实现处理函数时,可以让它接收 &Config 和具体命令参数,再返回 Result<ProcessResult, AppError>。其中 From<std::io::Error> for AppError 很重要:它允许后续代码对 I/O 操作直接使用 ?,同时仍保持统一的业务错误类型。
当结构体负责承载稳定字段、枚举负责表达互斥分支、Result 负责区分成功与失败后,核心处理流程就可以围绕这些类型展开,而不必反复检查大量彼此冲突的布尔值或可选字段。