Rust 编程语言

将模块分离到不同的文件中

到目前为止，本章中的所有示例都在一个文件中定义了多个模块。 当模块变大时，您可能希望将其定义移动到单独的 文件，使代码更易于导航。

例如，让我们从示例 7-17 中的代码开始，该代码具有多个 restaurant 模块。我们将模块提取到文件中，而不是将所有 modules 中定义的 crate 根文件。在这种情况下，crate 根文件是 src/lib.rs，但此过程也适用于其 crate 根的二进制 crate 文件为 src/main.rs。

首先，我们将提取front_of_housemodule 复制到自己的文件中。删除 代码front_of_house模块，仅留下 这mod front_of_house;声明，以便 src/lib.rs 包含代码 如示例 7-21 所示。请注意，在我们创建 src/front_of_house.rs 文件（如示例 7-22 所示）之前，它不会编译。

文件名： src/lib.rs

mod front_of_house;

pub use crate::front_of_house::hosting;

pub fn eat_at_restaurant() {
    hosting::add_to_waitlist();
}

示例 7-21：声明front_of_house模块，其 body 将位于 src/front_of_house.rs 中

接下来，将大括号中的代码放入一个名为 src/front_of_house.rs 的新文件中，如示例 7-22 所示。编译器知道要查找 在这个文件中，因为它在 crate 根目录中遇到了 module 声明 替换为名称front_of_house.

文件名： src/front_of_house.rs

pub mod hosting {
    pub fn add_to_waitlist() {}
}

示例 7-22： 其中的定义front_of_housesrc/front_of_house.rs 中的 module

请注意，您只需使用mod声明一次 模块树。一旦编译器知道该文件是项目的一部分（并且知道 代码所在的位置，因为您将mod语句），则项目中的其他文件应引用加载的文件的代码 使用指向声明位置的路径，如“引用路径”中所述 到 Module Tree 中的某个 Item“部分。换句话说，mod不是您可能在其他 编程语言。

接下来，我们将提取hostingmodule 复制到自己的文件中。这个过程有点 不同，因为hosting是front_of_house，而不是 root 模块。我们将文件hosting在将 以其在模块树中的祖先命名，在本例中为 src/front_of_house。

开始移动hosting，我们将 src/front_of_house.rs 更改为仅包含 的hosting模块：

文件名： src/front_of_house.rs

pub mod hosting;

然后我们创建一个 src/front_of_house 目录和一个 hosting.rs 文件，以 包含在hosting模块：

文件名： src/front_of_house/hosting.rs

pub fn add_to_waitlist() {}

如果我们改为将 hosting.rs 放在 src 目录中，编译器将 预期 hosting.rs 代码位于hosting在 crate 中声明的模块 root 的 root 版本，并且未声明为front_of_house模块。这 编译器的规则，用于检查哪些文件，哪些模块的代码意味着 目录和文件与模块树更匹配。

我们已将每个模块的代码移动到一个单独的文件中，模块树保持不变 一样。函数调用eat_at_restaurant无需任何 修改，即使定义位于不同的文件中。这 技术允许您在模块大小增加时将模块移动到新文件。

请注意，pub use crate::front_of_house::hostingsrc/lib.rs 中的语句也没有改变，也没有use对哪些文件有任何影响 作为 crate 的一部分进行编译。这modkeyword 声明模块，而 Rust 在与模块同名的文件中查找进入 那个模块。

总结

Rust 允许你将一个包拆分为多个 crate，将一个 crate 拆分为多个模块，因此 您可以从一个模块中引用另一个模块中定义的项。你可以做 这通过指定 absolute 或 relative paths 来实现。这些路径可以引入 scope 替换为use语句，以便您可以使用较短的路径来多次使用 该范围内的项。默认情况下，模块代码是私有的，但你可以将 定义 public 通过添加pub关键词。

在下一章中，我们将查看 standard 库，您可以在组织整齐的代码中使用。