You need to enable JavaScript to run this app. Rust 中 unit struct(单元结构体)的真实使用案例有哪些?
优惠活动
大模型
产品
解决方案
定价
更多

Rust 中 unit struct(单元结构体)的真实使用案例有哪些?

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 22:54:08