答案

Rust 中的模块系统围绕关键字 mod 构建。模块允许将代码逻辑上分割到文件和命名空间中。关键点：

• 默认为私有（private），仅在当前模块内可见。
• pub 使元素在整个模块树中可用。
• pub(crate) — 在整个 crate 中可用（即库/project）。
• 命名冲突通过命名空间解决：显式导入（use mod_name::item）和别名。

对于大型项目，建议使用模块树，仅通过 lib.rs 或 main.rs 描述公共接口，其余部分保持私有：

mod network;
mod storage;
pub use network::api;

设问

如果结构体被声明为 pub，它会对其他 crate 可用吗？

答案：不，单单标记结构体为 pub 是不够的。还必须在对外 crate 开放的模块中声明它（pub mod），并且结构体的字段也必须是公共的，以便直接访问。

示例：

mod foo { pub struct Bar; }
// Bar 在外部 crate 不可见，因为 foo 是私有的

由于对主题细节不了解而导致的实际错误示例

---

故事

在一个结构复杂的模块项目中，意外地将一个结构声明为 pub，但未将模块导出为 pub。后来尝试从另一个 crate 使用该结构时 - 收到了类型不可用的错误。

故事

在一个大型库中，不同模块导出了相同的名称（例如，types 和 errors）。在盲目使用 use * 时，编译阶段出现了命名冲突。解决方案是添加别名并仅导入所需的元素。

故事

很多初学者创建了 pub 结构体，但将字段保留为私有，这使得无法在模块外初始化它们。结果，来自另一个模块的函数无法直接创建结构体，这导致错误，直到字段或构造函数被设为公共之后。