第9章项目的结构和管理 on 编程那些事儿

01-模块

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/106_zh-cn.html

模块

每个 Rust 程序或者库都叫 crate。

每个 crate 都是由模块的层次结构组成。

每个 crate 都有一个根模块。

模块里面可以有全局变量、全局函数、全局结构体、全局 Trait 甚至是全局模块！

02-编写程序

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/107_zh-cn.html

编写程序

应用程序的根模块需要在一个叫 main.rs 的文件里面。

03-编写库

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/108_zh-cn.html

编写库

库的根模块需要在一个叫 lib.rs 的文件里面。

04-引用其他模块和 crate

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/109_zh-cn.html

引用其他模块和 crate

你可以使用完整的模块路径路径引用模块中的项目： std::f64::consts::PI。

更简单的方法是使用use关键字。此关键字可以让我们在代码中使用模块中的项目而无需指定完整路径。例如 use std::f64::consts::PI 这样我在 main 函数中只需要写 PI 就可以了。

05-引用多个项目

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/110_zh-cn.html

引用多个项目

在同一个模块路径中可以引用多个项目，比如：

1

use std::f64::consts::{PI,TAU}

Ferris 不吃桃（TAU），它只吃派（PI）。

06-创建模块

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/111_zh-cn.html

创建模块

当我们想到项目时，我们通常会想象一个以目录组织的文件层次结构。Rust 允许您创建与您的文件结构密切相关的模块。

07-模块层次结构

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/112_zh-cn.html

模块层次结构

模块可以互相依赖。要建立一个模块和其子模块之间的关系，你需要在父模块中这样写：

1

mod foo;

上面的声明将使编译器寻找一个名为 foo.rs 或 foo/mod.rs 的文件，并将其内容插入这个作用域内名为 foo 的模块中。

08-内联模块

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/113_zh-cn.html

内联模块

一个子模块可以直接内联在一个模块的代码中。

内联模块最常见的用途是创建单元测试。下面我们创建一个只有在使用 Rust 进行测试时才会存在的内联模块！

09-模块内部引用

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/114_zh-cn.html

模块内部引用

你可以在你的 use 路径中使用如下 Rust 关键字来获得你想要的模块：

crate - 你的 crate 的根模块
super - 当前模块的父模块
self - 当前模块

10-导出

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/115_zh-cn.html

导出

默认情况下，模块的成员不能从模块外部访问（甚至它的子模块也不行！）。我们可以使用 pub 关键字使一个模块的成员可以从外部访问。

11-结构体可见性

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/116_zh-cn.html

结构体可见性

就像函数一样，结构体可以使用 pub 声明它们想要在模块外暴露的东西。

示例代码

1
2
3
4
5
6
7
8
9


// SeaCreature 结构体在我们的模块外面也能使用了
pub struct SeaCreature {
 pub animal_type: String,
 pub name: String,
 pub arms: i32,
 pub legs: i32,
 // 我们把武器信息保密起来好了
 weapon: String,
}

12-Prelude

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/117_zh-cn.html

Prelude

你可能很好奇，为什么我们在没用 use 导入 Vec 或 Box 的情况下却可以到处使用它们。这是因为标准库中有一个叫 prelude 的模块。

13-你自己的 Prelude

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/118_zh-cn.html

你自己的 Prelude

你看，既然标准库里面有 prelude，那么你自己的库里面最好也要有一个 prelude 模块。这个模块可以作为其他使用你的库的用户的起点：他们可以借此导入你的库里面所有常用的数据结构 (例如 use my_library::prelude::*)。当然，这个模块就不会在用了你的库的程序或别的库里面自动启用了。不过使用这个惯例的话，大家会很轻松地知道从何开始的。

14-第九章 - 总结

Mon, 17 Aug 2026 22:00:00 +0800

内容来源 · Tour of Rust / Rust 语言之旅

原文链接: https://tourofrust.com/119_zh-cn.html

第九章 - 总结

现在，你应该学会了如何创建并与世界分享你的 Rust 应用程序和库了。不要担心现在记不住这些东西。等以后你的库发展了，用的人多了，你自己会清楚每个阶段应该做什么的。

第9章 项目的结构和管理 on 编程那些事儿

01-模块

模块

02-编写程序

编写程序

03-编写库

编写库

04-引用其他模块和 crate

引用其他模块和 crate

05-引用多个项目

引用多个项目

06-创建模块

创建模块

07-模块层次结构

模块层次结构

08-内联模块

内联模块

09-模块内部引用

模块内部引用

10-导出

导出

11-结构体可见性

结构体可见性

示例代码

12-Prelude

Prelude

13-你自己的 Prelude

你自己的 Prelude

14-第九章 - 总结

第九章 - 总结

第9章项目的结构和管理 on 编程那些事儿