779 字

4 分钟

Rust 模块系统（mod）教程 6day

2025-11-03

rust

/

rust-mod

🦀 Rust 模块系统（mod）教程#

目录#

模块概念
基本语法
文件与目录结构
pub 与私有性
引入模块（use）
嵌套模块
进阶技巧：路径、重导出
综合示例
总结

1️⃣ 模块概念#

Rust 的模块（module）是 组织代码的单位：

将函数、结构体、枚举、常量等逻辑分组
避免命名冲突
控制访问范围（公开或私有）

模块可以嵌套形成层次结构。

2️⃣ 基本语法#

1
mod network {
2
    pub fn connect() {
3
        println!("Connecting...");
4
    }
5

6
    fn private_function() {
7
        println!("这是私有函数");
8
    }
9
}
10

11
fn main() {
12
    network::connect();      // ✅ 可访问
13
    // network::private_function(); // ❌ 编译错误
14
}

mod xxx 定义模块
默认模块成员是 私有的，使用 pub 可公开

3️⃣ 文件与目录结构#

Rust 可以将模块分散到不同文件：

文件结构示例#

1
src/
2
├── main.rs
3
├── network.rs
4
└── utils/
5
    ├── mod.rs
6
    └── math.rs

main.rs#

1
mod network;  // 引入 network.rs 模块
2
mod utils;    // 引入 utils/mod.rs 模块
3

4
fn main() {
5
    network::connect();
6
    utils::math::add(2, 3);
7
}

network.rs#

1
pub fn connect() {
2
    println!("Connecting...");
3
}

utils/mod.rs#

1
pub mod math; // 引入 math.rs

utils/math.rs#

1
pub fn add(a: i32, b: i32) -> i32 {
2
    a + b
3
}

mod.rs 用作目录模块的入口文件（Rust 2018+ 还可以用 utils.rs + utils/ 子模块方式）。

4️⃣ pub 与私有性#

默认私有：模块内部可以访问，外部不可访问
pub：公开访问
pub(crate)：同包可访问
pub(super)：父模块可访问
pub(self)：当前模块可访问（冗余，但可用）

1
mod outer {
2
    pub mod inner {
3
        pub fn hello() { println!("Hello"); }
4
        fn secret() { println!("Secret"); }
5
    }
6
}
7
fn main() {
8
    outer::inner::hello(); // ✅ 可访问
9
    // outer::inner::secret(); // ❌ 编译错误
10
}

5️⃣ 引入模块（use）#

use 可以简化模块路径访问：

1
mod network {
2
    pub fn connect() { println!("Connecting..."); }
3
}
4

5
use network::connect;
6

7
fn main() {
8
    connect(); // 不需要写 network::connect
9
}

导入全部内容#

1
use network::*;

起别名#

1
use network::connect as net_connect;
2
fn main() { net_connect(); }

6️⃣ 嵌套模块#

模块可以无限嵌套：

1
mod app {
2
    pub mod network {
3
        pub fn connect() { println!("Connecting..."); }
4
    }
5

6
    pub mod db {
7
        pub fn query() { println!("Querying..."); }
8
    }
9
}
10

11
fn main() {
12
    app::network::connect();
13
    app::db::query();
14
}

使用 use 可以简化路径：

1
use app::network::connect;
2
connect();

7️⃣ 进阶技巧#

1. 重导出（pub use）#

1
mod network {
2
    pub fn connect() { println!("Connecting..."); }
3
}
4

5
pub use network::connect; // 外部可以直接调用 connect

2. 相对路径#

1
mod outer {
2
    pub mod inner {
3
        pub fn hello() { println!("Hello"); }
4
    }
5
    pub fn call_inner() {
6
        super::outer::inner::hello(); // 或使用 crate::outer::inner::hello()
7
    }
8
}

3. 内部私有访问#

模块内部可以直接访问同级模块的私有成员。

8️⃣ 综合示例#

项目结构：

1
src/
2
├── main.rs
3
├── network.rs
4
└── utils/
5
    ├── mod.rs
6
    └── math.rs

main.rs#

1
mod network;
2
mod utils;
3

4
use network::connect;
5
use utils::math::add;
6

7
fn main() {
8
    connect();
9
    println!("2 + 3 = {}", add(2, 3));
10
}

network.rs#

1
pub fn connect() {
2
    println!("Connecting to server...");
3
}

utils/mod.rs#

1
pub mod math;

utils/math.rs#

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

运行：

1
Connecting to server...
2
2 + 3 = 5

9️⃣ 总结#

mod 用于声明模块，默认私有
pub 用于公开模块或成员
文件模块：mod.rs 或 mod_name.rs
use 用于引入模块并简化路径
模块支持嵌套与重导出
Rust 模块系统支持清晰、可维护、可重用的项目结构

💡 练习建议：

创建一个 src/services/ 目录，包含 network.rs 和 db.rs 模块
使用 use 在 main.rs 调用模块函数
尝试使用 pub(crate) 和 pub(super) 管理访问范围
尝试重导出模块函数，简化调用路径

Rust 模块系统（mod）教程 6day

https://iqwq.com/posts/rust/study-mod-demo-6day/

作者

Xiaolin

发布于

2025-11-03

许可协议

CC BY-NC-SA 4.0

rust study 5day

Rust Vector（Vec）教程 7day