Rust 中 unit struct(单元结构体)的真实使用案例有哪些?
单元结构体定义为struct Name;,属于零大小类型(ZST),不存储任何数据,运行时不占用内存空间,在实际项目中有非常多落地场景,以下是最常见的几类:
作为类型标记实现 trait 做行为区分
最典型的就是状态机的状态标记,比如你要实现一个订单状态流转的状态机,不需要在状态里存额外数据,只需要用不同的单元结构体代表不同状态,再为每个状态实现对应的行为trait即可:// 不同订单状态都是单元结构体 struct Created; struct Paid; struct Delivered; // 为每个状态实现对应的行为 trait OrderState { fn next(&self) -> Option<Box<dyn OrderState>>; } impl OrderState for Created { fn next(&self) -> Option<Box<dyn OrderState>> { Some(Box::new(Paid)) } }这种实现比用枚举做状态更灵活,每个状态的行为可以独立拆分,不会把所有状态逻辑堆在同一个枚举的match分支里。
作为错误类型占位
当你需要返回Result但是错误场景不需要携带任何额外错误信息时,完全可以用自定义的单元结构体做错误类型,比用单元类型()语义清晰很多:struct ParseFailed; fn parse_config(input: &str) -> Result<Config, ParseFailed> { if input.is_empty() { return Err(ParseFailed); } // 后续解析逻辑 }调用方看到
ParseFailed就能直接知道错误类型,不需要额外注释说明空()代表什么错误。作为事件/消息类型的标记
事件驱动架构里很多事件不需要携带payload,直接用单元结构体做事件类型即可,比如定时任务触发事件、心跳事件,不需要存任何数据,只要类型本身就能代表事件含义:struct HeartbeatEvent; struct ScheduleTriggerEvent; // 事件处理逻辑 fn handle_event(event: &dyn Event) { if let Some(_) = event.as_any().downcast_ref::<HeartbeatEvent>() { // 处理心跳逻辑 } }用于实现零成本的配置标记
很多库会用单元结构体代表不同的配置选项,用户选择不同的单元结构体传入就能切换库的行为,完全没有运行时开销,比如序列化库的格式化选项:struct CompactFormat; struct PrettyFormat; trait FormatOption { fn indent(&self) -> Option<usize>; } impl FormatOption for CompactFormat { fn indent(&self) -> Option<usize> { None } } impl FormatOption for PrettyFormat { fn indent(&self) -> Option<usize> { Some(4) } }因为是零大小类型,不管传多少个这种配置标记,都不会占用额外内存,性能和硬编码逻辑完全一致。
作为单元测试的标记类型
写单元测试时经常需要为某个泛型接口做测试实现,不需要存储测试数据的话就可以用单元结构体做测试实现的类型,避免额外的内存开销。
内容的提问来源于stack exchange,提问作者Roby Cigar

