掌握Rust模块系统（从零开始学习Rust模块定义方法）

什么是模块？

模块在 Rust 中就像一个个“文件夹”，用于将相关功能组织在一起。每个模块可以包含函数、结构体、枚举、常量等，并且可以通过 pub 关键字控制哪些内容对外可见。

1. 在单个文件中定义模块

最简单的模块定义方式是在同一个 .rs 文件中使用 mod 关键字：

mod my_module {    pub fn public_function() {        println!("这是公开函数");    }    fn private_function() {        println!("这是私有函数，只能在模块内部调用");    }}fn main() {    my_module::public_function(); // ✅ 可以调用    // my_module::private_function(); // ❌ 编译错误！}

注意：pub 是关键！没有它，函数默认是私有的，外部无法访问。

2. 将模块拆分到单独文件

当项目变大时，通常会把模块放到独立的文件中。例如：

• src/main.rs
• src/my_module.rs

src/my_module.rs 内容：

pub fn greet() {    println!("Hello from my_module!");}pub struct User {    pub name: String,}

src/main.rs 内容：

mod my_module; // 声明模块，Rust 会自动查找 my_module.rsfn main() {    my_module::greet();    let user = my_module::User {        name: "Alice".to_string(),    };    println!("User: {}", user.name);}

3. 使用子模块构建层级结构

你还可以创建嵌套模块。例如：

• src/network/mod.rs
• src/network/tcp.rs
• src/network/udp.rs

src/network/mod.rs 内容：

pub mod tcp;pub mod udp;

src/network/tcp.rs 内容：

pub fn connect() {    println!("Connecting via TCP...");}

src/main.rs 调用方式：

mod network;fn main() {    network::tcp::connect();}

4. 使用 use 简化路径

频繁写完整路径很麻烦，可以用 use 引入：

use network::tcp;fn main() {    tcp::connect(); // 更简洁！}// 或者直接引入函数use network::tcp::connect;fn main() {    connect(); // 最简洁！}

总结

通过以上方法，你可以灵活地使用 Rust模块系统 来组织项目结构。记住几个关键点：

• 用 mod 声明模块
• 用 pub 控制可见性
• 模块可放在同文件或独立文件（.rs 或 mod.rs）
• 用 use 简化调用路径

掌握这些 Rust模块定义 技巧，是成为高效 Rust 开发者的必经之路。希望这篇 Rust语言教程 能帮助每一位 Rust新手入门 的朋友打下坚实基础！