【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 的最小编译单元,可以理解为"当前项目/包"。这种写法通常是为了隐藏内部实现,只给外部暴露更高层次的接口。

相关推荐
皮皮林55115 分钟前
京东又开源一款新框架,用起来真优雅!
后端
学长毕设29 分钟前
基于SpringBoot智慧养老服务平台设计与实现-附源码
java·spring boot·后端
曹牧1 小时前
Java:“刷新雪崩”
java·开发语言
郝学胜-神的一滴1 小时前
Effective STL 条款03:容器中的对象复制要廉价且正确
开发语言·数据结构·c++·算法·rpc·stl
西西弗Sisyphus2 小时前
C++ explicit 关键字工程实践
开发语言·c++
郝学胜-神的一滴3 小时前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
行百里er3 小时前
【Spring Insight 技术分享】跨服务调用链路是怎么串起来的?
后端·spring·开源
火山引擎和TA的超级拍档们3 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
源动力技术栈4 小时前
C# 集合类型全览:从 List<T> 到 FrozenDictionary,配一组实测数据
后端
aleimu4 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端