Rust 中 package crate 和 module 的关系

1.简介

在 Rust 中，这三者构成了代码组织的层次结构：

• 一个包（Package）可以包含一个或多个 Crate；

一个包中至多 只能 包含一个库 crate（library crate）；包中可以包含任意多个二进制 crate（binary crate）；包中至少包含一个 crate，无论是库的还是二进制的。

• 每个 Crate 则由若干 Module 组成。

为了更清晰地理解它们的对应关系，可以参考下面的表格：

2.关系梳理与代码示例

2.1 Rust 中的层级关系

包 (Package) → Crate → 模块 (Module)。

一个项目通常以一个“包”开始（即你运行cargo new创建的东西）。这个包声明了它所包含的 Crate。

# Cargo.toml - 定义了一个“包” [package] name = "my_project" version = "0.1.0" edition = "2021" # 一个包可以声明一个库Crate和一个二进制Crate... [lib] name = "my_lib" path = "src/lib.rs" [[bin]] name = "my_app" path = "src/main.rs"

在代码层面，Crate 的根文件是入口，你可以通过mod关键字在其内部定义模块。

// src/lib.rs (这是库Crate 'my_lib'的根)pubmodnetwork{// 定义一个名为 'network' 的模块pubfnconnect(){// 这是一个公开函数println!("Connecting...");}}modutils;// 声明另一个在 src/utils.rs 或 src/utils/mod.rs 中的模块

2.2 对应的Go代码组织

Go 语言的层级更扁平，通常一个目录就是一个package，而一个包含go.mod文件的目录则定义了一个 Go Module。

my-go-project/ // 项目根目录 (类似Rust的包概念，但不完全等同) ├── go.mod // ✅ 定义 Go Module (对应Rust的Crate) ├── main.go // ✅ 属于 main package (对应Rust的模块) ├── utils/ // 子目录 │ └── utils.go // ✅ 属于 utils package (对应Rust的模块)

// go.mod - 定义了一个 Go Modulemodule github.com/me/my-go-projectgo1.22

// utils/utils.go - 定义了utils包packageutils// Connect 函数是公开的 (首字母大写)funcConnect(){println("Connecting...")}

3.核心区别

1. 可见性控制不同

• Rust：单元粒度是模块 (Module)。父模块可以访问子模块的私有项，但外部 Crate 只能访问标记为pub的项。Rust 没有“导出整个模块”的快捷方式，需要显式控制。

• Go：单元粒度是包 (Package)。同一个包内的不同文件可以互相访问所有项，不需要额外声明。包内的私有项通过首字母小写来限定，公开项通过首字母大写来标识。

2. 文件与代码的对应关系

• Rust：文件路径通常需要与模块树结构保持一致。模块声明（mod）是显式的，你可以选择内联模块代码或将代码放在单独的文件中。
• Go：目录名与包名强相关。一个目录下的所有.go文件都属于同一个包，无需显式声明包含关系。

4.总结

• Rust的“包” (Package)：构建和项目管理单元，对应一个Cargo.toml文件。它在Go语言中没有直接等同的概念。
• Rust 的 Crate：编译和依赖的基本单元，对应Go中的Go Module (go.mod)。
• Rust的模块 (Module)：代码组织和可见性控制单元，对应Go中的Go Package (package)。

参考文献

Rust 程序设计语言