第10章模块 on 编程那些事儿

01-可见性

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/mod/visibility.html

可见性

默认情况下，模块中的项拥有私有的可见性（private visibility），不过可以加上 pub 修饰语来重载这一行为。模块中只有公有的（public）项可以从模块外的作用域访问。

02-结构体的可见性

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/mod/struct_visibility.html

结构体的可见性

结构体的字段也是一个可见性的层次。字段默认拥有私有的可见性，也可以加上 pub 修饰语来重载该行为。只有从结构体被定义的模块之外访问其字段时，这个可见性才会起作用，其意义是隐藏信息（即封装，encapsulation）。

03-`use` 声明

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/mod/use.html

`use` 声明

use 声明可以将一个完整的路径绑定到一个新的名字，从而更容易访问。

 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
27
28
29
30
31
32
33


// 将 `deeply::nested::function` 路径绑定到 `other_function`。
use deeply::nested::function as other_function;

fn function() {
 println!("called `function()`");
}

mod deeply {
 pub mod nested {
 pub fn function() {
 println!("called `deeply::nested::function()`")
 }
 }
}

fn main() {
 // 更容易访问 `deeply::nested::funcion`
 other_function();

 println!("Entering block");
 {
 // 这和 `use deeply::nested::function as function` 等价。
 // 此 `function()` 将遮蔽外部的同名函数。
 use deeply::nested::function;
 function();

 // `use` 绑定拥有局部作用域。在这个例子中，`function()`
 // 的遮蔽只存在这个代码块中。
 println!("Leaving block");
 }

 function();
}

04-`super` 和 `self`

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/mod/super.html

`super` 和 `self`

可以在路径中使用 super （父级）和 self（自身）关键字，从而在访问项时消除歧义，以及防止不必要的路径硬编码。

 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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49


fn function() {
 println!("called `function()`");
}

mod cool {
 pub fn function() {
 println!("called `cool::function()`");
 }
}

mod my {
 fn function() {
 println!("called `my::function()`");
 }
 
 mod cool {
 pub fn function() {
 println!("called `my::cool::function()`");
 }
 }
 
 pub fn indirect_call() {
 // 让我们从这个作用域中访问所有名为 `function` 的函数！
 print!("called `my::indirect_call()`, that\n> ");
 
 // `self` 关键字表示当前的模块作用域——在这个例子是 `my`。
 // 调用 `self::function()` 和直接调用 `function()` 都得到相同的结果，
 // 因为他们表示相同的函数。
 self::function();
 function();
 
 // 我们也可以使用 `self` 来访问 `my` 内部的另一个模块：
 self::cool::function();
 
 // `super` 关键字表示父作用域（在 `my` 模块外面）。
 super::function();
 
 // 这将在 *crate* 作用域内绑定 `cool::function` 。
 // 在这个例子中，crate 作用域是最外面的作用域。
 {
 use crate::cool::function as root_function;
 root_function();
 }
 }
}

fn main() {
 my::indirect_call();
}

05-文件分层

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/mod/split.html

文件分层

模块可以分配到文件/目录的层次结构中。让我们将《可见性》一节中的例子的代码拆分到多个文件中：

1
2
3
4
5
6
7


$ tree .
.
|-- my
| |-- inaccessible.rs
| |-- mod.rs
| `-- nested.rs
`-- split.rs

split.rs 的内容：

第10章 模块 on 编程那些事儿

01-可见性

可见性

02-结构体的可见性

结构体的可见性

03-`use` 声明

use 声明

04-`super` 和 `self`

super 和 self

05-文件分层

文件分层

第10章模块 on 编程那些事儿

`use` 声明

`super` 和 `self`