Rust / 系统课时
认识包与 Crate
认识包与 Crate
在 Rust 项目里,package、crate 和 Cargo 清单经常一起出现,但它们解决的是不同层次的问题。理解三者后,你就能判断一个目录会产出几个编译单元、入口文件在哪里,以及 Cargo 如何组织构建。
学习目标
- 区分 package、binary crate 与 library crate 的职责
- 识别
Cargo.toml、src/main.rs和src/lib.rs的默认关系 - 能用 Cargo 验证一个包中的 crate 是否可正常编译
从三个名词切开
package 是 Cargo 管理项目的单位,crate 是 Rust 编译器处理的编译单元。 一个 package 由一个 Cargo.toml 描述,并且至少包含一个 crate。crate 又分为可执行的 binary crate 和供其他代码复用的 library crate。
| 概念 | 主要作用 | 常见默认入口 |
|---|---|---|
| package | 描述依赖、版本和构建目标 | Cargo.toml |
| binary crate | 编译为可执行程序,必须有 main 函数 |
src/main.rs |
| library crate | 编译为库,向其他 crate 暴露 API | src/lib.rs |
一个 package 最多只有一个 library crate,但可以包含多个 binary crate;除默认的 src/main.rs 外,还可以通过 src/bin/ 下的源文件增加二进制目标。

Cargo 清单如何描述包
最小的 Cargo.toml 会在 [package] 中记录包名、版本和 edition;依赖写在 [dependencies] 中。只要目录采用 Cargo 的默认布局,通常不需要手工声明 src/main.rs 或 src/lib.rs。
[package]
name = "crate-demo"
version = "0.1.0"
edition = "2024"
# 使用默认目标路径,无需显式声明 src/main.rs 或 src/lib.rs
[dependencies]这份清单本身不会决定项目只能有哪一种 crate。若同时存在 src/main.rs 与 src/lib.rs,Cargo 会把它们视为同一 package 中的一个默认 binary crate 和一个 library crate。
用 Cargo 验证编译单元
进入 package 根目录后运行:
cargo check -q预期结果
无输出,进程退出码为 0。cargo check 会完成解析、类型检查和依赖检查,但不会生成最终可执行文件,因此很适合快速确认 crate 入口和模块声明是否正确。实际失败时,Cargo 会给出具体文件、行号和诊断信息。
容易混淆的边界
crate root 是一个 crate 的根源文件:默认 binary crate 的根是 src/main.rs,默认 library crate 的根是 src/lib.rs。从 crate root 开始,mod 再继续构建模块树。
package 名称主要服务于 Cargo;crate 名称则出现在 Rust 路径和编译产物中。日常判断时先问“这是 Cargo 管理的哪个 package”,再问“这个 package 里有哪些 crate”,通常就不会把包、库和模块混在一起。