《Rust编程入门》11.2 包与 crate 的概念

11.2 包与 crate 的概念

Rust 的 包（package） 和 crate 是构建和组织代码的核心概念。它们帮助开发者管理代码模块化、依赖以及构建流程。

11.2.1 什么是 crate？

Crate 的定义

• Crate 是 Rust 中的最小编译单元。
• 它可以是一个二进制可执行文件（binary crate）或一个库文件（library crate）。
• 每个 crate 都包含一个顶层模块作为其根。

二进制 crate

• Binary crate 是编译后生成的可执行文件，必须包含一个 main 函数作为程序入口。
• 例如：

1
2
3

fn main() {
    println!("Hello, Rust!");
}

以上代码将被编译为一个二进制 crate。

库 crate

• Library crate 是一个可以被其他 crate 或程序使用的库，不需要 main 函数。
• 通过 lib.rs 文件定义一个 crate 的库接口：

1
2
3

pub fn add(a: i32, b: i32) -> i32 {
    a + b
}

11.2.2 什么是包？

包的定义

• Package 是一个或多个 crate 的集合，用于组织和管理代码。
• 每个包都包含一个 Cargo.toml 文件，用于描述包的元信息和依赖。

包与 crate 的关系

• 一个包 最多 包含一个库 crate。
• 一个包 可以 包含多个二进制 crate。
• 包可以通过 src/main.rs 和 src/bin/ 文件夹中的多个文件定义二进制 crate。

示例：一个包含库和二进制 crate 的包

目录结构：

1
2
3
4
5
6
7

my_package/
├── Cargo.toml
├── src/
│   ├── lib.rs
│   ├── main.rs
│   ├── bin/
│       ├── tool.rs

• src/main.rs：默认的二进制 crate。
• src/lib.rs：默认的库 crate。
• src/bin/tool.rs：额外的二进制 crate。

11.2.3 Cargo.toml 文件

Cargo.toml 是每个包的核心配置文件。它定义了包的元信息、依赖项和构建配置。

Cargo.toml 示例

1
2
3
4
5
6
7

[package]
name = "my_package"            # 包的名称
version = "0.1.0"              # 包的版本
edition = "2021"               # Rust 版本

[dependencies]
serde = "1.0"                  # 依赖的库和版本

主要字段说明

1. [package]
   描述包的基本信息，包括名称、版本、作者等。

2. [dependencies]
   定义包所依赖的其他库或 crate，可以指定版本号、源地址等。

3. [dev-dependencies]
   定义仅在开发或测试环境中使用的依赖。

11.2.4 创建包与 crate

使用 Cargo 创建包

cargo new 命令可以快速创建一个包含基本结构的包：

1

cargo new my_package

生成的目录结构：

1
2
3
4

my_package/
├── Cargo.toml
├── src/
│   └── main.rs

默认情况下：

• src/main.rs 是二进制 crate。
• 如果想创建一个库包，可以使用 --lib 参数：

1

cargo new my_library --lib

生成的目录结构：

1
2
3
4

my_library/
├── Cargo.toml
├── src/
│   └── lib.rs

11.2.5 使用 crate.io 和依赖管理

crates.io

• crates.io 是 Rust 的官方包管理平台，用于共享和下载 crate。
• 开发者可以通过 Cargo.toml 引入 crates.io 上的库作为依赖。

引入依赖

在 Cargo.toml 中添加依赖：

1
2

[dependencies]
rand = "0.8" # 引入 rand 库

使用依赖：

1
2
3
4
5
6
7

use rand::Rng;

fn main() {
    let mut rng = rand::thread_rng();
    let n: u32 = rng.gen_range(0..10);
    println!("Random number: {}", n);
}

指定依赖版本

• 固定版本："1.2.3"
• 版本范围："^1.2" 表示兼容 1.x 版本。
• 最新版本："*"（不推荐）

本地或 Git 仓库依赖

• 使用本地 crate：

1
2

[dependencies]
my_local_lib = { path = "../my_local_lib" }

• 使用 Git 仓库：

1
2

[dependencies]
serde = { git = "https://github.com/serde-rs/serde" }

11.2.6 包与 crate 的设计建议

1. 模块化设计：将逻辑分解为多个 crate，有助于提高代码的可读性和复用性。
2. 明确依赖：避免引入不必要的依赖，确保包的轻量和安全。
3. 合理定义 API：在库 crate 中，清晰地定义公共接口，隐藏实现细节。
4. 发布与版本管理：遵循 语义化版本管理（SemVer） 标准，确保包的更新不破坏现有用户的代码。

11.2.7 小结

• Crate 是 Rust 的最小编译单元，可以是二进制或库。
• Package 是一个或多个 crate 的集合，用于组织和管理代码。
• 通过 Cargo 和 crates.io，开发者可以轻松管理依赖和构建流程。

下一节将深入讲解 Rust 的模块的公有性和私有性，探讨如何通过模块组织和复用代码，为Rust项目的扩展性打下坚实基础。

• Rust
• Rust Tutors
• Rust编程入门