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

相关推荐
兩尛5 小时前
c++知识点2
开发语言·c++
fengfuyao9855 小时前
海浪PM谱及波形的Matlab仿真实现
开发语言·matlab
xiaoye-duck6 小时前
C++ string 底层原理深度解析 + 模拟实现(下)——面试 / 开发都适用
开发语言·c++·stl
Hx_Ma166 小时前
SpringMVC框架提供的转发和重定向
java·开发语言·servlet
期待のcode7 小时前
原子操作类LongAdder
java·开发语言
lly2024068 小时前
C 语言中的结构体
开发语言
JAVA+C语言8 小时前
如何优化 Java 多主机通信的性能?
java·开发语言·php
青岑CTF9 小时前
攻防世界-Ics-05-胎教版wp
开发语言·安全·web安全·网络安全·php
Li emily10 小时前
如何通过外汇API平台快速实现实时数据接入?
开发语言·python·api·fastapi·美股
APIshop10 小时前
Java 实战:调用 item_search_tmall 按关键词搜索天猫商品
java·开发语言·数据库