Rust 模块化文件组织

简介

在本实验中，代码示例中模块的文件层次结构如下所示：有一个名为“my”的目录，其中包含两个文件，“inaccessible.rs”和“nested.rs”。此外，还有一个名为“my.rs”的文件和一个名为“split.rs”的文件。“split.rs”文件包含在“my.rs”文件中定义的模块“my”，而“my.rs”文件分别包含在“inaccessible.rs”和“nested.rs”文件中定义的模块“inaccessible”和“nested”。

注意：如果实验未指定文件名，你可以使用任何你想要的文件名。例如，你可以使用main.rs，并通过rustc main.rs &&./main进行编译和运行。

文件层次结构

模块可以映射到文件/目录层次结构。让我们详细分析一下文件中的可见性示例：

$ tree.
.
├── my
│   ├── inaccessible.rs
│   └── nested.rs
├── my.rs
└── split.rs

在 split.rs 中：

// 此声明将查找名为 `my.rs` 的文件，并将其内容插入到此作用域下名为 `my` 的模块中
mod my;

fn function() {
    println!("called `function()`");
}

fn main() {
    my::function();

    function();

    my::indirect_access();

    my::nested::function();
}

在 my.rs 中：

// 同样，`mod inaccessible` 和 `mod nested` 将定位 `nested.rs`
// 和 `inaccessible.rs` 文件，并将它们插入到各自的模块下
mod inaccessible;
pub mod nested;

pub fn function() {
    println!("called `my::function()`");
}

fn private_function() {
    println!("called `my::private_function()`");
}

pub fn indirect_access() {
    print!("called `my::indirect_access()`, that\n> ");

    private_function();
}

在 my/nested.rs 中：

pub fn function() {
    println!("called `my::nested::function()`");
}

#[allow(dead_code)]
fn private_function() {
    println!("called `my::nested::private_function()`");
}

在 my/inaccessible.rs 中：

#[allow(dead_code)]
pub fn public_function() {
    println!("called `my::inaccessible::public_function()`");
}

让我们检查一下一切是否仍像以前一样正常工作：

$ rustc split.rs &&./split
called `my::function()`
called `function()`
called `my::indirect_access()`, that
> called `my::private_function()`
called `my::nested::function()`

总结

恭喜你！你已经完成了文件层次结构实验。你可以在 LabEx 中练习更多实验来提升你的技能。