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

Rust模块系统实战

news 2026/7/6 19:46:47

Rust模块系统实战

后端转 Rust 的萌新，ID "第一程序员"——名字大，人很菜（暂时）。正在跟所有权和生命周期死磕，日常记录 Rust 学习路上的踩坑经验和"啊哈时刻"，代码片段保证能跑。保持学习，保持输出。欢迎大佬们轻喷，也欢迎同好一起进步。

前言

最近在学习 Rust 的过程中，我开始关注模块系统。作为一个从后端转 Rust 的萌新，我认为了解 Rust 的模块系统是非常有必要的，它可以帮助我们组织和管理代码，提高代码的可维护性和可读性。

Rust 的模块系统非常强大，它允许我们将代码组织成模块、包和 crate，同时提供了灵活的可见性控制。今天，我就来分享一下 Rust 模块系统的相关知识和实战经验，希望能帮到和我一样的萌新们。

模块系统的基本概念

什么是模块

模块是 Rust 中组织代码的基本单位，它可以包含函数、结构体、枚举、常量等。

模块的层次结构

crate：是 Rust 编译的基本单位，可以是二进制 crate 或库 crate
包（package）：包含一个或多个 crate，以及 Cargo.toml 文件
模块（module）：组织代码的基本单位，可以嵌套
路径（path）：用于引用模块、函数、结构体等的名称

模块的可见性

pub：公开的，可以被其他模块访问
private：私有的，只能在当前模块及其子模块中访问

基本模块使用

创建模块

// src/main.rs mod greeting { pub fn hello() { println!("Hello, world!"); } fn private_function() { println!("This is a private function"); } } fn main() { greeting::hello(); // greeting::private_function(); // 会编译错误，因为 private_function 是私有的 }

分离模块到单独的文件

src/greeting.rs

pub fn hello() { println!("Hello, world!"); } fn private_function() { println!("This is a private function"); }

src/main.rs

mod greeting; fn main() { greeting::hello(); }

创建模块目录

src/math/mod.rs

pub mod arithmetic; pub mod geometry;

src/math/arithmetic.rs

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

src/math/geometry.rs

pub fn area_of_circle(radius: f64) -> f64 { std::f64::consts::PI * radius * radius } pub fn area_of_rectangle(width: f64, height: f64) -> f64 { width * height }

src/main.rs

mod math; fn main() { println!("1 + 2 = {}", math::arithmetic::add(1, 2)); println!("5 - 3 = {}", math::arithmetic::subtract(5, 3)); println!("Area of circle with radius 2: {}", math::geometry::area_of_circle(2.0)); println!("Area of rectangle 3x4: {}", math::geometry::area_of_rectangle(3.0, 4.0)); }

模块的可见性控制

基本可见性

mod outer { pub fn outer_public() { println!("Outer public function"); inner::inner_private(); // 可以访问子模块的私有函数 } fn outer_private() { println!("Outer private function"); } mod inner { pub fn inner_public() { println!("Inner public function"); } pub(crate) fn inner_crate() { println!("Inner crate function"); } fn inner_private() { println!("Inner private function"); } } } fn main() { outer::outer_public(); // outer::outer_private(); // 编译错误 // outer::inner::inner_public(); // 编译错误，因为 inner 模块是私有的 }

使用 pub(crate)

mod utils { pub(crate) fn helper() { println!("Helper function"); } } mod module1 { use crate::utils::helper; pub fn function1() { helper(); } } mod module2 { use crate::utils::helper; pub fn function2() { helper(); } } fn main() { module1::function1(); module2::function2(); // utils::helper(); // 编译错误，因为 helper 是 crate 可见的 }

使用 pub(super)

mod outer { pub fn outer_function() { println!("Outer function"); } mod inner { pub fn inner_function() { println!("Inner function"); super::outer_function(); // 可以访问父模块的公开函数 } } } fn main() { outer::outer_function(); outer::inner::inner_function(); }

模块的导入

使用 use 关键字

mod math { pub mod arithmetic { pub fn add(a: i32, b: i32) -> i32 { a + b } } } use crate::math::arithmetic; fn main() { println!("1 + 2 = {}", arithmetic::add(1, 2)); }

重命名导入

mod math { pub mod arithmetic { pub fn add(a: i32, b: i32) -> i32 { a + b } } } use crate::math::arithmetic as arith; fn main() { println!("1 + 2 = {}", arith::add(1, 2)); }

导入特定项

mod math { pub mod arithmetic { pub fn add(a: i32, b: i32) -> i32 { a + b } pub fn subtract(a: i32, b: i32) -> i32 { a - b } } } use crate::math::arithmetic::add; fn main() { println!("1 + 2 = {}", add(1, 2)); // subtract(5, 3); // 编译错误，因为没有导入 }

导入所有项

mod math { pub mod arithmetic { pub fn add(a: i32, b: i32) -> i32 { a + b } pub fn subtract(a: i32, b: i32) -> i32 { a - b } } } use crate::math::arithmetic::*; fn main() { println!("1 + 2 = {}", add(1, 2)); println!("5 - 3 = {}", subtract(5, 3)); }

实战案例：构建一个简单的库

项目结构

my-library/ ├── Cargo.toml └── src/ ├── lib.rs ├── utils/ │ ├── mod.rs │ └── string.rs └── math/ ├── mod.rs ├── arithmetic.rs └── geometry.rs

Cargo.toml

[package] name = "my-library" version = "0.1.0" edition = "2021" # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html [dependencies]

src/lib.rs

pub mod utils; pub mod math;

src/utils/mod.rs

pub mod string;

src/utils/string.rs

pub fn capitalize(s: &str) -> String { let mut chars = s.chars(); match chars.next() { None => String::new(), Some(first) => first.to_uppercase().to_string() + chars.as_str(), } } pub fn reverse(s: &str) -> String { s.chars().rev().collect() }

src/math/mod.rs

pub mod arithmetic; pub mod geometry;

src/math/arithmetic.rs

pub fn add(a: i32, b: i32) -> i32 { a + b } pub fn subtract(a: i32, b: i32) -> i32 { a - b } pub fn multiply(a: i32, b: i32) -> i32 { a * b } pub fn divide(a: i32, b: i32) -> Option<f64> { if b == 0 { None } else { Some(a as f64 / b as f64) } }

src/math/geometry.rs

pub fn area_of_circle(radius: f64) -> f64 { std::f64::consts::PI * radius * radius } pub fn area_of_rectangle(width: f64, height: f64) -> f64 { width * height } pub fn area_of_triangle(base: f64, height: f64) -> f64 { 0.5 * base * height }

使用库

src/main.rs

use my_library::utils::string; use my_library::math::{arithmetic, geometry}; fn main() { // 测试字符串工具 let s = "hello world"; println!("Original: {}", s); println!("Capitalized: {}", string::capitalize(s)); println!("Reversed: {}", string::reverse(s)); // 测试算术函数 println!("1 + 2 = {}", arithmetic::add(1, 2)); println!("5 - 3 = {}", arithmetic::subtract(5, 3)); println!("2 * 3 = {}", arithmetic::multiply(2, 3)); println!("6 / 2 = {:?}", arithmetic::divide(6, 2)); println!("6 / 0 = {:?}", arithmetic::divide(6, 0)); // 测试几何函数 println!("Area of circle with radius 2: {}", geometry::area_of_circle(2.0)); println!("Area of rectangle 3x4: {}", geometry::area_of_rectangle(3.0, 4.0)); println!("Area of triangle base=4, height=5: {}", geometry::area_of_triangle(4.0, 5.0)); }