一、前言
在 Rust 中，代码组织是通过 crate、package 和 module 来实现的。理解这些概念对于构建大型、可维护的 Rust 项目至关重要。本文将深入探讨 Rust 中的这三个概念，并提供相应的示例。
二、Rust Crate（箱）
在 Rust 中，crate 是一个编译单元。它可以包含模块（modules）和其他 crate。每个 Rust 程序至少有一个 crate，即 main crate，它通常由 src/main.rs 文件定义。
Rust crate 还可以是库 crate，它不会生成可执行文件，而是供其他 crate 使用。库 crate 由 src/lib.rs 文件定义。
三、Rust Package（包）
Rust package 是一个或多个crate的集合。它还包含元数据（metadata），如 crate 名称和版本号等，用于在 Cargo 生态系统中管理这些 crate。package 通过 Cargo.toml 文件定义。
四、Rust Module（模块）
Rust module 是一个封装了一组相关功能的方式。它可以用于在 crate 内部组织代码，也可以控制项目的公共 API。module 通过 mod 关键字定义。
4.1 在 Crate 内部组织代码
模块允许你将相关的函数、结构体和 trait 分组到一起，使得代码更易于理解和维护。例如：
// src/main.rs
mod math {
pub fn add(a: i32, b: i32) -> i32 {
a + b
}
}
fn main() {
println!("{}", math::add(1, 2)); // 输出: 3
}
4.2 控制公共 API
模块还可以用于定义 crate 的公共 API。默认情况下，Rust 中的项目（函数、结构体等）是私有的，只能在同一模块内访问。使用 pub 关键字可以将项目标记为公共的，从而允许其他 crate 和模块访问它们。
五、总结
Rust 中的 crate、package 和 module 是构建大型、可维护的 Rust 项目的基石。理解这些概念对于编写高质量的 Rust 代码至关重要。希望本文能够帮助你更好地理解并使用它们。