在本章中，我们将探讨如何在 Rust 项目中调用其他 Rust 代码。这包括如何组织代码结构、如何通过模块系统进行代码重用以及如何使用外部库来扩展功能。
模块系统与代码组织
Rust 的模块系统允许开发者将代码分割成多个模块，从而更好地组织和管理代码。模块系统是 Rust 语言的核心特性之一，它帮助开发者创建可维护、可复用的代码库。
创建模块
创建模块通常涉及定义一个新的模块文件或目录，并在主程序中声明这个模块。例如，如果你有一个名为 utils 的模块，可以这样定义：
// utils.rs 文件内容
pub fn add_two(a: i32) -> i32 {
a + 2
}然后在主程序中引入该模块：
mod utils;
fn main() {
println!("结果: {}", utils::add_two(5));
}这里，mod utils; 语句告诉编译器存在一个名为 utils 的模块，而 utils::add_two(5) 则调用了该模块中的函数。
使用 use 关键字简化导入
为了使代码更简洁，你可以使用 use 关键字来导入模块中的项。例如：
mod utils;
use utils::add_two;
fn main() {
println!("结果: {}", add_two(5));
}在这个例子中，use utils::add_two; 使得 add_two 函数可以直接使用，无需再写 utils:: 前缀。
子模块
子模块允许你进一步细分模块，以实现更加复杂的代码结构。例如，如果你的项目需要处理不同的数据类型，可以为每种类型创建子模块。
假设我们有一个处理向量数据的模块：
// vectors.rs 文件内容
pub fn calculate_length(v: &Vec<i32>) -> f64 {
(v.len() as f64).sqrt()
}然后在主模块中引入并使用它：
-- -------------------- ---- -------
--- --------
--- ------
--- --------------------------
--- ---------------
-- ------ -
--- --- - ------- -- ---
--------------- ---- ------------------------
------------- ---- ------------
-外部库
除了自定义模块外，Rust 还提供了强大的外部库生态系统，可以用来快速扩展项目的功能。Cargo 是 Rust 的包管理器，它可以帮助你轻松地添加和管理外部依赖。
假设你想使用 rand 库生成随机数，首先需要在 Cargo.toml 文件中添加依赖：
[dependencies] rand = "0.8"
然后在代码中使用该库：
use rand::Rng; // 引入随机数生成器的 trait
fn main() {
let mut rng = rand::thread_rng();
let random_number: i32 = rng.gen();
println!("随机数: {}", random_number);
}在这个例子中，我们通过 rand::thread_rng() 获取了一个线程局部的随机数生成器，并使用 gen() 方法生成了一个随机整数。
包含私有代码
除了公共函数和模块外，你还可以创建私有代码，这些代码只能在定义它们的模块内部访问。使用 pub 关键字控制项的可见性：
-- -------------------- ---- -------
-- - -------- ---
--- -- ----------------- -
-------------------
-
-- ------------------ -
-------------------
-
--- --- ---------- -
--- -- ------------------------- -
------------------------
-
-在这个例子中，public_function 和 sub_module::another_public_function 可以从外部调用，而 private_function 则不能。
总结
通过以上内容，我们了解了如何在 Rust 项目中有效地组织和调用代码。从基本的模块定义到使用外部库，这些知识将帮助你在开发过程中保持代码的清晰性和可维护性。接下来，我们可以继续探索更多高级主题，如泛型、生命周期等，以进一步提升你的 Rust 编程技能。