【Rust自学】7.1. Package、Crate和定义Module
喜欢的话别忘了点赞、收藏加关注哦，对接下来的教程有兴趣的可以关注专栏。谢谢喵！(=･ω･=)
7.1.1. Rust的代码组织
代码组织主要包括：
- 那些细节可以对外暴露，而哪些细节是私有的
- 在作用域内哪些名称有效
- …
这些功能被统称为模块系统，模块系统中包含（顺序从大概念到小概念）：
- Package(包):Cargo的特性，让你构建、测试和共享crate。可以理解为项目
- Crate(单元包):一个模块树，它可以产生一个library或可执行文件。
- Module(模块):它让你控制代码的组织、作用域和私有路径
- Path(路径):为struct、function或module等条目命名的方式
7.1.2. 包(Package)与单元包(Crate)
crate分为两种类型：
- binary(二进制)：一个可以独立运行的可执行程序，必须包含一个 main 函数，作为程序的入口点。通常用于实现具体的应用程序或命令行工具。
- library(库)：一个用于共享和重用的代码模块，不能直接运行。没有 main 函数，而是通过公开的函数或模块供其他代码调用。
crate root指的是源代码文件(也就是.rs文件)，而且是入口文件（比如main.rs），Rust编译器会从这里开始组成crate的根Module
一个Package包含：
- 一个Cargo.toml，它描述了如何构建这些Crates
- 要么有一个，要么就没有library crate
- 可以有任意数量的binary crate
- 但至少得有一个crate(不管是library还是binary)
7.1.3. Cargo的惯例
如果你打开本地Rust项目的Cargo.toml，就比如说我的：
[package]
name = "RustStudy"
version = "0.1.0"
edition = "2021"
[dependencies]
rand = "0.8.5"
你会发现没有提到入口文件，这是因为Cargo默认把src/main.rs当作binary crate的crate root，crate的名与Package相同，也就是binary crate的名与包名相同都是RustStudy(toml文件第二行写了)。这是约定大于配置的思想。
假如说这个项目里（也可以说是Package里）在src目录下有lib.rs这么一个文件，这就是说这个Package包含一个library crate，而这个lib.rs就是library crate的crate root。而这个crate的名与package的名也是相同的，都是RustStudy。
Cargo会把crate root文件交给rustc来构建library或者binary
刚刚提到过，一个Package里可以有很多个binary crate，这时可以把源代码文件（也就是.rs文件）放在src/bin这个目录下，这下面的每个文件都是单独的binary crate(单独的程序)
7.1.4. Crate 的作用
crate的作用是将相关功能组合到一个作用域内，便于在项目里间进行分享。同时也可以防止命名的冲突。比如生成随机数的这个rand crate，访问它的功能就需要通过它的名字rand。
7.1.5. 定义Module来控制作用域和私有性
Module是在一个crate里将代码进行分组，也就是分为若干个模块(Module)的功能，它可以增加代码的可读性，并且使功能易于复用。它可以控制条目(item)的私有性。控制它们是public（对外暴露）的还是private（私有）的。
建立module需要使用mod这个关键字，在后面写这个module的名字，在名字后边使用花括号。
其次，module是可以嵌套的，里面的就叫做子module，在module里可以包含其他项（struct、enum、常量、trait、函数等）的定义。
还是看个例子吧（在src目录下的lib.rs里写）：
mod front_of_house {
mod hosting {
fn add_to_waitlist() {}
fn seat_at_table() {}
}
mod serving {
fn take_order() {}
fn serve_order() {}
fn take_payment() {}
}
}
在这个例子中,hosting和serving就是front_of_the_house的子module,front_of_the_house就被称为父module,而在这两个子module下还定义了好几个函数。
main.rs和lib.rs叫做crate roots。这两个文件的内容就会隐式形成名为crate的模块，位于整个模块树的根部（图中的最顶层）。下图就是刚刚那个lib.rs的模块树：
crate
└── front_of_house
├── hosting
│ ├── add_to_waitlist
│ └── seat_at_table
└── serving
├── take_order
├── serve_order
└── take_payment