0 引入

任何一门编程语言如果不能组织代码都是难以深入的，几乎没有一个软件产品是由一个源文件编译而成的。本教程到目前为止所有的程序都是在一个文件中编写的，主要是为了方便学习 Rust 语言的语法和概念。对于一个工程来讲，组织代码是十分重要的。Rust 中有三个重要的组织概念：箱、包、模块。

1、组织概念

下面是按照逐渐递增大小关系说明的

1. 1、箱

1、"箱"是二进制程序文件或者库文件，存在于"包"中。
2、"箱"是树状结构的，它的树根是编译器开始运行时编译的源文件所编译的程序。
3、注意：“二进制程序文件"不一定是"二进制可执行文件”，只能确定是是包含目标机器语言的文件，文件格式随编译环境的不同而不同。

1. 2、包

1、当我们使用 Cargo 执行 new 命令创建 Rust 工程时，工程目录下会建立一个 Cargo.toml 文件。工程的实质就是一个包，包必须由一个 Cargo.toml 文件来管理，该文件描述了包的基本信息以及依赖项。
2、一个包最多包含一个库"箱"，可以包含任意数量的二进制"箱"，但是至少包含一个"箱"（不管是库还是二进制"箱"）。
3、当使用 cargo new 命令创建完包之后，src 目录下会生成一个 main.rs 源文件，Cargo 默认这个文件为二进制箱的根，编译之后的二进制箱将与包名相同。

1. 3、模块

1、对于一个软件工程来说，我们往往按照所使用的编程语言的组织规范来进行组织，组织模块的主要结构往往是树。Java 组2、织功能模块的主要单位是类，而 JavaScript 组织模块的主要方式是 function。
这些先进的语言的组织单位可以层层包含，就像文件系统的目录结构一样。Rust 中的组织单位是模块（Module）。
3、在文件系统中，目录结构往往以斜杠在路径字符串中表示对象的位置，Rust 中的路径分隔符是 :: 。
路径分为绝对路径和相对路径。绝对路径从 crate 关键字开始描述。相对路径从 self 或 super 关键字或一个标识符开始描述。

mod nation {
    mod government {
        fn govern() {}
    }
    mod congress {
        fn legislate() {}
    }
    mod court {
        fn judicial() {}
    }
}

//访问时候可以使用 相对路径也可以使用绝对路径
crate::nation::government::govern();    //绝对
nation::government::govern();           //相对

2、组织中权限

2.1 权限

Rust 中有两种简单的访问权：公共（public）和私有（private）。
默认情况下，如果不加修饰符，模块中的成员访问权将是私有的。
如果想使用公共权限，需要使用 pub 关键字。
对于私有的模块，只有在与其平级的位置或下级的位置才能访问，不能从其外部访问。
如果模块中定义了结构体，结构体除了其本身是私有的以外，其字段也默认是私有的。所以如果想使用模块中的结构体以及其字段，需要 pub 声明（枚举不具备该性质）。

mod nation {
    pub mod government {
        pub fn govern() {}
    }
    mod congress {
        pub fn legislate() {}
    }
    mod court {
        fn judicial() {
            super::congress::legislate();
        }
    }
}
fn main() {
    nation::government::govern();
}

2.2 模块引用

现在两个模块
test1.rs 代码如下

pub fn message() -> String {
    String::from("This is the 2nd module.")
}

main.rs 代码如下

mod test1;

fn main() {
    println!("This is the main module.");
    println!("{}", second_module::message());
}

这样是可以引用成功的。

2.2 Use 关键词

使用use可以引用标准库，也可以引用自定义的，这样就比较方便，解决了局部模块路径过长的问题。和python中的 import有点类似，和C++中的use namespace用法异曲同工。当然也可以使用use xxx as 作为别名使用
代码如下（示例）：

mod nation {
    pub mod government {
        pub fn govern() {}
    }
}
use crate::nation::government::govern;       // use 过之后
use crate::nation::govern as nation_govern;  // 别名

fn main() {
	nation_govern();
    govern();
}