模块

模块是零个或多个项的容器。

_模块项_是一个模块，用花括号括起来，命名，并以关键字 mod 为前缀。模块项在构成 crate 的模块树中引入一个新的、命名的模块。

模块可以任意嵌套。

模块示例：

#![allow(unused)]
fn main() {
mod math {
    type Complex = (f64, f64);
    fn sin(f: f64) -> f64 {
        /* ... */
      unimplemented!();
    }
    fn cos(f: f64) -> f64 {
        /* ... */
      unimplemented!();
    }
    fn tan(f: f64) -> f64 {
        /* ... */
      unimplemented!();
    }
}
}

模块在它们所在的模块或块的类型命名空间中定义。

在同一模块内的同一命名空间中定义多个同名项是错误的。有关限制和遮蔽行为的更多详细信息，请参阅作用域章节。

unsafe 关键字在语法上允许出现在 mod 关键字之前，但在语义级别上被拒绝。这允许宏消费该语法并使用 unsafe 关键字，然后将其从词法单元流中移除。

模块源文件名

没有主体的模块从外部文件加载。当模块没有 path 属性时，文件的路径反映逻辑模块路径。

祖先模块路径组件是目录，模块的内容在以模块名称加 .rs 扩展名命名的文件中。例如，以下模块结构可以具有此相应的文件系统结构：

模块文件名也可以是模块名称作为目录，内容在该目录中名为 mod.rs 的文件中。上面的示例可以 alternately 表示为 crate::util 的内容在名为 util/mod.rs 的文件中。不允许同时拥有 util.rs 和 util/mod.rs。

path 属性

用于加载外部文件模块的目录和文件可以通过 path 属性来影响。

对于不在内联模块块上的模块上的 path 属性，文件路径相对于源文件所在的目录。例如，以下代码片段将根据其位置使用所示的路径：

#[path = "foo.rs"]
mod c;

对于内联模块块内的 path 属性，文件路径的相对位置取决于 path 所在的源文件的种类。“mod-rs” 源文件是根模块（如 lib.rs 或 main.rs）和文件名为 mod.rs 的模块。“non-mod-rs” 源文件是所有其他模块文件。mod-rs 文件中内联模块块内 path 属性的路径相对于 mod-rs 文件的目录，包括内联模块组件作为目录。对于 non-mod-rs 文件，除了路径以 non-mod-rs 模块名称的目录开头外，其余相同。例如，以下代码片段将根据其位置使用所示的路径：

mod inline {
    #[path = "other.rs"]
    mod inner;
}

结合上述 path 属性在内联模块和嵌套模块上的规则的示例（适用于 mod-rs 和 non-mod-rs 文件）：

#[path = "thread_files"]
mod thread {
    // Load the `local_data` module from `thread_files/tls.rs` relative to
    // this source file's directory.
    #[path = "tls.rs"]
    mod local_data;
}

模块上的属性

模块与所有项一样，接受外部属性。它们也接受内部属性：对于有主体的模块，在 { 之后，或者在源文件的开头，在可选的 BOM 和 shebang 之后。

在模块上有意义的内置属性是 cfg、deprecated、doc、lint 检查属性、path 和 no_implicit_prelude。模块也接受宏属性。