掌握Rust模块系统（详解Rust模块可见性与访问控制）

什么是模块（Module）？

在 Rust 中，模块（module） 是组织代码的一种方式。你可以把模块想象成一个“文件夹”，里面可以包含函数、结构体、枚举、常量，甚至其他子模块。模块帮助我们将大型项目拆分成逻辑清晰的小单元。

默认情况下，模块中的所有项（items）都是 私有的（private），这意味着只有该模块内部的代码可以访问它们。这就是 Rust私有模块 的默认行为。

如何让模块对外可见？——使用 pub 关键字

要让模块或其中的项对外部可见，你需要使用 pub 关键字。这是控制 Rust模块可见性 的核心机制。

示例 1：公有模块与私有函数

mod my_module {    // 这个函数是私有的，只能在 my_module 内部调用    fn private_function() {        println!("This is private!");    }    // 使用 pub 让这个函数对外公开    pub fn public_function() {        println!("This is public!");        private_function(); // 模块内部可以调用私有函数    }}fn main() {    // my_module::private_function(); // ❌ 编译错误！不能访问私有函数    my_module::public_function();     // ✅ 正确！可以调用公有函数}

在这个例子中，my_module 是一个私有模块（因为没有加 pub），但它的内部有一个 pub fn public_function()。然而，由于整个模块是私有的，外部代码根本无法访问 my_module 本身！

示例 2：公有模块 + 公有函数

// 使用 pub 声明模块为公有pub mod my_module {    pub fn public_function() {        println!("Hello from public module!");    }}fn main() {    my_module::public_function(); // ✅ 成功调用}

现在，my_module 是公有的，且其中的函数也是公有的，因此主函数可以正常调用它。这就是 Rust公有函数 的典型用法。

更细粒度的可见性控制

除了简单的 pub，Rust 还支持更精细的可见性控制，例如：

• pub(crate)：仅在当前 crate（项目）内可见
• pub(super)：仅在父模块中可见
• pub(in path)：在指定路径的模块中可见

示例 3：使用 pub(crate)

mod inner {    // 仅在当前 crate 内可见    pub(crate) fn helper() {        println!("Crate-private helper");    }}fn main() {    inner::helper(); // ✅ 在同一个 crate 中可以调用}

总结

- 默认情况下，Rust 中的所有项都是私有的。
- 使用 pub 可以将模块、函数、结构体等设为公有。
- 要让外部代码访问某个函数，不仅函数本身要 pub，其所在的模块也必须是 pub。
- 利用 pub(crate) 等语法可以实现更安全的封装。

掌握 Rust模块可见性 是写出结构清晰、安全可靠的 Rust 代码的关键一步。希望这篇教程能帮助你轻松理解这一重要概念！

关键词：Rust模块可见性, Rust pub关键字, Rust私有模块, Rust公有函数