【rust】 pub(crate) 的用法

rust 复制代码
pub(crate) struct Aile {
    f: tokio::fs::File,
    cur_file: String,
    t_offset: i64,
    r: String,
}

pub(crate) 是什么意思?

  • Rust 里用来修饰可见性(visibility)的关键字。

  • pub:公共,任何地方都能访问。

  • pub(crate)只在当前 crate 内可见

    • 也就是说,这个 AdFile 结构体在同一个 crate 的模块之间可以自由使用。

    • 但是如果别的 crate 依赖了这个库,就不能直接访问 AdFile


什么是 crate?

  • crate 是 Rust 的编译单元,可以是:

    • 一个 可执行程序 (binary crate,比如 main.rs)。

    • 或者一个 (library crate,比如 lib.rs)。

  • 一个 crate 可以包含多个 模块(mod)

  • 举个比喻:

    • crate ≈ 一个独立项目(或一个包)。

    • mod ≈ 这个项目里的子目录/文件。

为什么要用 pub(crate)

你这里的 Aile 明显是日志记录模块内部的实现细节:

  • 只想让 同一个项目里的其他模块 (比如 AdTracker)能用它;

  • 但不希望被 crate 之外的用户直接访问(避免外部 API 污染或误用)。

这样做的好处:

  1. 封装性 :外部用户只能通过你暴露的更高级 API(比如 AdTracker),而不是直接操作 AdFile

  2. 灵活性:内部结构随时能调整,不会破坏对外接口的稳定性。

pub(crate) 限制 AdFile 只能在当前 crate 内使用。crate 是 Rust 的最小编译单元,可以理解为"当前项目/包"。这种写法通常是为了隐藏内部实现,只给外部暴露更高层次的接口

相关推荐
扫地的小何尚24 分钟前
一小时内使用NVIDIA Nemotron创建你自己的Bash计算机使用智能体
开发语言·人工智能·chrome·bash·gpu·nvidia
alwaysrun32 分钟前
Rust中的智能指针
rust·智能指针·pin·cow·box·arc
程序员三明治32 分钟前
Spring AOP:注解配置与XML配置双实战
java·后端·spring·代理模式·aop·1024程序员节
绝无仅有33 分钟前
京东面试题解析:同步方法、线程池、Spring、Dubbo、消息队列、Redis等
后端·面试·github
MoonBit月兔34 分钟前
MoonBit Pearls Vol.12:初探 MoonBit 中的 JavaScript 交互
开发语言·javascript·数据库·交互·moonbit
非凡ghost36 分钟前
Tenorshare 4DDiG(数据恢复软件) 最新版
前端·javascript·后端
来一杯龙舌兰1 小时前
【Sentinel】Springboot整合Sentinel、Socket进行熔断限流(生产级熔断限流)
spring boot·后端·sentinel·熔断限流
绝无仅有1 小时前
京东面试题解析:String与StringBuilder的区别、装箱拆箱、重载与重写总结
后端·面试·github
草莓熊Lotso1 小时前
《算法闯关指南:优选算法--二分查找》--23.寻找旋转排序数组中的最小值,24.点名
开发语言·c++·算法·1024程序员节
非凡ghost1 小时前
WinMute(自动锁屏静音软件) 中文绿色版
前端·javascript·后端