当前位置：首页 > news >正文

Rust 中 package crate 和 module 的关系

news 2026/6/29 17:34:15

文章目录

1.简介
2.关系梳理与代码示例
- 2.1 Rust 中的层级关系
- 2.2 对应的Go代码组织
3.核心区别
4.总结
参考文献

1.简介

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

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

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

每个 Crate 则由若干 Module 组成。

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

概念 (Rust)	Rust 含义	对应Go的概念
包 (Package)	由一个`Cargo.toml`文件构建的单元，可以包含一个或多个Crate。是最高层的代码组织单元。	❌无直接对应。Go的工作区(Workspace)功能与之略有相似，但定位不同。
Crate	一个独立的编译单元，可以被编译成一个可执行文件或一个库。是版本控制和依赖管理的基本单元。	✅Go Module (`go.mod`)
模块 (Module)	一个Crate内部的命名空间，用于控制代码的可见性和组织代码结构。	✅Go Package (`package`)

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. 文件与代码的对应关系