3 模块 on 编程那些事儿

3.1 模块

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/modules/modules.html

3.1 模块

我们已经见过 impl 块如何把函数归入某个类型的命名空间。

类似地，mod 可以把类型和函数放入命名空间：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0
mod foo {
 pub fn do_something() {
 println!("In the foo module");
 }
}

mod bar {
 pub fn do_something() {
 println!("In the bar module");
 }
}

fn main() {
 foo::do_something();
 bar::do_something();
}

包（package）提供功能，并包含一个描述如何构建一捆（1 个或多个）crate 的 Cargo.toml 文件。

Crate 是一棵模块树：二进制 crate 生成可执行文件，库 crate 编译为库。

模块（module）定义组织方式与作用域，是本节的重点。

3.2 文件系统层次结构

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/modules/filesystem.html

3.2 文件系统层次结构

省略模块内容会告诉 Rust 到另一个文件中查找：

1
2
3


// Copyright 2022 Google LLC
// SPDX-License-Identifier: Apache-2.0
mod garden;

这表示 garden 模块的内容位于 src/garden.rs。类似地，garden::vegetables 模块可以位于 src/garden/vegetables.rs。

3.3 可见性

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/modules/visibility.html

3.3 可见性

模块是一道隐私边界：

模块中的项默认是私有的（隐藏实现细节）。
父模块与兄弟模块中的项始终可见。
换言之，若某个项在模块 foo 中可见，则在 foo 的所有后代模块中也可见。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


// Copyright 2022 Google LLC
// SPDX-License-Identifier: Apache-2.0
mod outer {
 fn private() {
 println!("outer::private");
 }

 pub fn public() {
 println!("outer::public");
 }

 mod inner {
 fn private() {
 println!("outer::inner::private");
 }

 pub fn public() {
 println!("outer::inner::public");
 super::private();
 }
 }
}

fn main() {
 outer::public();
}

使用 pub 关键字让模块变为公开。

此外，还有更高级的 pub(...) 说明符，可限制公开可见性的范围。

3.4 封装

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/modules/encapsulation.html

3.4 封装

与模块中的项一样，结构体字段默认也是私有的。私有字段在模块其余部分（包括子模块）中同样可见。这让我们能够封装结构体的实现细节，控制对外可见的数据与功能。

3.5 `use`、`super`、`self`

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/modules/paths.html

3.5 `use`、`super`、`self`

模块可以用 use 把另一个模块中的符号引入作用域。每个模块顶部通常会看到类似这样的写法：

1
2
3
4


// Copyright 2022 Google LLC
// SPDX-License-Identifier: Apache-2.0
use std::collections::HashSet;
use std::process::abort;

路径

路径按如下方式解析：

3 模块 on 编程那些事儿

3.1 模块

3.1 模块

3.2 文件系统层次结构

3.2 文件系统层次结构

3.3 可见性

3.3 可见性

3.4 封装

3.4 封装

3.5 `use`、`super`、`self`

3.5 use、super、self

路径

3.5 `use`、`super`、`self`