第 4 章：模块与包管理

第 4 章：模块与包管理

4.1 cargo 基础

Cargo 是 Rust 的包管理器和构建工具。

• cargo new project_name
• cargo build
• cargo run
• cargo test

Cargo.toml

[package]
name = "my_project"
version = "0.1.0"
edition = "2021"

[dependencies]

• 在 [dependencies] 中添加依赖库

4.2 模块系统

模块用于组织代码：

mod front_of_house {
    pub fn serve_order() {}
}

fn main() {
    front_of_house::serve_order();
}

• mod 声明模块
• pub 控制可见性

文件与模块对应

• mod foo; 对应 foo.rs
• mod bar {} 对应内联模块

4.3 包与依赖

• crate 是一个编译单元
• 包可以包含一个或多个 crate
• 工作区可以管理多个包

[workspace]
members = ["crate_a", "crate_b"]

4.4 文档注释与生成

Rust 使用三斜线注释生成文档：

/// 这是一个计算两个数之和的函数。
fn add(a: i32, b: i32) -> i32 {
    a + b
}

运行 cargo doc --open 生成 HTML 文档。

4.5 练习

• 创建一个新的 Cargo 项目，并编写一个简单库
• 将功能拆分为多个模块和子模块
• 添加第三方依赖并使用它