rust *究竟*如何查找模块？

Question

rust 用于从文件中查找模块的确切规则集是什么？

我在网上找到的关于模块的每一个解释都说，“这是模块的目的，这里是一个例子，......”没有一个完整、全面、100% 准确的解释rust 如何查找模块。 即使是 rust参考也没有告诉您 crate root 和导入文件是否都需要声明mod 。 没有简单的规则集我可以用来判断它是否会起作用。

我正在寻找可以遵循的东西，例如：

1. Rust 看名字，解析:: like subdir::subdir::name
2. name.rs看同目录下是否有文件名.rs 和name/mod.rs
3. 不允许同时存在name.rs和name/mod.rs 。
4. 那么，Rust……？？？

Answer 1

这最好从内联模块开始解释。 模块从 crate 根开始排列成层次结构。 每个板条箱，经过一些脱糖后，看起来像这样：

// root

pub mod a {
    pub mod b {
        pub const X: u8 = 1;
    }
}

mod foo {
    
}

引用树中的项目非常简单：

• ::下降一个级别
• super:: “上升”一个级别
• crate::进入根级别

引用X的示例：

• a::b::X来自 crate 根目录
• crate::a::b::X从板条箱中的任何位置
• super::a::b::X来自模块foo
• b::X来自模块a

mod a; 实际上只是以下任何一项的语法糖：

#[path = "foo.rs"]
mod foo;
// or
#[path = "foo/mod.rs"]
mod foo;

这进一步脱糖：

mod foo {
    include!("foo.rs");
}
// or
mod foo {
    include!("foo/mod.rs");
}

如果foo.rs （或foo/mod.rs ）包含一个mod bar; 那么整棵树看起来像：

mod foo {
    mod bar {
        // contents of `bar.rs` (or `foo/bar/mod.rs`)
    }

    // remaining contents of `foo.rs`
}

请注意，虽然仍受支持，但不鼓励使用mod.rs 相反，建议将foo.rs用于crate::foo并将 foo 的任何子模块放在foo foo/目录中。

crate::只是总是对应于当时正在编译的根目录。 如果您的 crate 足够复杂或不遵循约定，那么某些crate::...项目路径可以引用不同文件中的不同内容。 但是通过遵循约定可以很容易地避免混淆。