Rust中如何直接引用跨文件夹结构体？简化模块导入路径

我有一个Rust项目，目录结构如下：

├── main.rs
├── structs
│   ├── mod.rs
│   ├── student.rs
│   └── date.rs

各文件代码如下：

structs/mod.rs #

pub mod date;
pub mod student;

structs/date.rs #

pub struct Date {
    pub day: i8,
    pub month: i8,
    pub year: i16,
}

impl Date {
    pub fn new(day: i8, month: i8, year: i16) -> Date {
        return Date {
            day,
            month,
            year
        };
    }
}

structs/student.rs #

use crate::structs::date::Date;

pub struct Student {
    pub name: String,
    pub age: i32,
    pub email: String,
    pub dob: Date,
}

impl Student {
    pub fn new(name: &str, age: i32, email: &str, dob: Date) -> Student {
        return Student {
            name: String::from(name),
            age,
            email: String::from(email),
            dob,
        };
    }
}

main.rs #

mod structs;

fn main() {
    let mut students = Vec::<structs::student::Student>::new();

    students.push(
        structs::student::Student::new(
            "Sahil Verma",
            21,
            "sahil@gmail.com",
            structs::date::Date::new(3, 9, 2001),
        )
    );
}

目前我需要使用完整路径如structs::date::Date来引用结构体，希望能直接使用Date、Student这类名称，请问该如何实现，或是有什么最佳目录结构可以让模块自动导入？

方法一：使用use语句导入+模块重导出 #

这是Rust中最常用的方式，既能保持文件结构清晰，又能简化结构体的引用。

步骤1：在模块根目录重导出结构体 #

修改structs/mod.rs，将子模块中的结构体直接导出到structs模块下：

pub mod date;
pub mod student;

// 将Date和Student重导出到structs模块层级
pub use date::Date;
pub use student::Student;

步骤2：在main.rs中导入使用 #

在main.rs顶部通过use导入需要的结构体，之后就能直接用短名称引用：

mod structs;
// 直接从structs模块导入目标结构体
use structs::{Date, Student};

fn main() {
    let mut students = Vec::<Student>::new();

    students.push(
        Student::new(
            "Sahil Verma",
            21,
            "sahil@gmail.com",
            Date::new(3, 9, 2001),
        )
    );
}

如果不想修改mod.rs，也可以直接在main.rs中导入子模块的结构体：

mod structs;
use structs::date::Date;
use structs::student::Student;

// 后续使用逻辑和上面一致

方法二：合并模块结构（适合小型项目） #

如果你的结构体逻辑比较简单，也可以将所有结构体代码合并到structs/mod.rs中，省去子文件的层级：

修改structs/mod.rs #

pub struct Date {
    pub day: i8,
    pub month: i8,
    pub year: i16,
}

impl Date {
    pub fn new(day: i8, month: i8, year: i16) -> Date {
        Date { day, month, year }
    }
}

pub struct Student {
    pub name: String,
    pub age: i32,
    pub email: String,
    pub dob: Date,
}

impl Student {
    pub fn new(name: &str, age: i32, email: &str, dob: Date) -> Student {
        Student {
            name: name.into(),
            age,
            email: email.into(),
            dob,
        }
    }
}

之后删除原有的date.rs和student.rs，main.rs的导入逻辑和之前一致即可。

这种方式适合代码量较小的场景，当结构体的逻辑变得复杂后，还是推荐拆分文件+重导出的方案，更利于长期维护。

内容的提问来源于stack exchange，提问作者Sahil Verma