Rust中的pub use重导出（模块组织的魔法钥匙）

什么是重导出？

在Rust中，每个模块（module）默认是私有的，也就是说，只有它自己和它的子模块能访问它内部的内容。如果你想让其他模块或外部crate使用你模块里的函数、结构体等，就需要用 pub 关键字来声明为公有。

但有时候，你希望把A模块里的某个项“搬到”B模块里，并让B模块对外暴露它——这就叫重导出。而 pub use 正是用来干这件事的。

一个简单的例子

假设我们有如下项目结构：

src/├── main.rs└── utils/    ├── mod.rs    └── math.rs

math.rs 文件内容：

// src/utils/math.rspub fn add(a: i32, b: i32) -> i32 {    a + b}

mod.rs 文件内容（用于声明 utils 模块）：

// src/utils/mod.rsmod math;// 重导出 math 模块中的 add 函数pub use self::math::add;

现在，在 main.rs 中就可以直接通过 utils::add 来调用了：

// src/main.rsmod utils;fn main() {    let result = utils::add(3, 5);    println!("3 + 5 = {}", result); // 输出：3 + 5 = 8}

注意：如果没有 pub use，你就只能写成 utils::math::add，而且前提是 math 模块本身也是 pub 的。通过重导出，我们可以简化路径，隐藏内部结构，提供更清晰的公共API。

为什么需要 pub use？

• 简化API：用户不需要知道内部模块结构，只需从一个入口访问功能。
• 封装内部实现：你可以随时调整内部模块结构，只要保持重导出的接口不变，外部代码就不受影响。
• 组合多个来源：可以把来自不同模块甚至不同crate的项集中到一个模块中统一导出。

高级用法：通配符与别名

你还可以使用通配符 * 重导出整个模块：

pub use self::math::*; // 导出 math 模块中所有 pub 项

或者用 as 给重导出的项起个别名：

pub use self::math::add as sum; // 现在外部可以通过 utils::sum 调用

SEO关键词回顾

本文深入讲解了 Rust pub use 的基本概念与实用技巧，帮助你掌握 Rust 重导出 的核心机制。这是理解 Rust 模块系统 和实现良好封装的关键一环，也是进行 Rust 可见性控制 的重要手段。

小结

pub use 不仅是一个语法糖，更是Rust模块设计哲学的体现：既保证安全性，又提供灵活性。通过合理使用重导出，你可以构建出清晰、稳定且易于使用的库接口。

下次当你想“整理”你的模块对外暴露的内容时，别忘了这把魔法钥匙——pub use！