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/ 下的源文件增加二进制目标。

Package、binary crate 与 library crate 的包含关系

Cargo 清单如何描述包

最小的 Cargo.toml 会在 [package] 中记录包名、版本和 edition;依赖写在 [dependencies] 中。只要目录采用 Cargo 的默认布局,通常不需要手工声明 src/main.rs 或 src/lib.rs。

toml
[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 根目录后运行:

bash
cargo check -q

预期结果

text
无输出,进程退出码为 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”,通常就不会把包、库和模块混在一起。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识包与 Crate

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通