一、module模块

crate规则：

• 规则一：一个包中必须至少包含一个crate
• 规则二：一个包中可以不包含库crate或者包含1个库crate
  规则三：一个包中可以包含任意数量的二进制crate

1.二进制文件的cargo项目

bin下面一个rs文件就是一个crate

2.库的cargo项目

模块中使用crate关键字

mod front_of_house {pub mod hosting {pub fn add_to_waitlist() {}}
}pub fn eat_at_restaurant() {// 绝对路径// 使用crate的原因是：// crate 的被称为 模块树 的模块结构的根部:https://rustwiki.org/zh-CN/book/ch07-03-paths-for-referring-to-an-item-in-the-module-tree.htmlcrate::front_of_house::hosting::add_to_waitlist();// 相对路径front_of_house::hosting::add_to_waitlist();
}

模块中使用super

fn serve_order() {}mod back_of_house {fn fix_incorrect_order() {cook_order();// 访问父模块的函数super::serve_order();}fn cook_order() {}
}

模块中结构体的访问规则

mod back_of_house {pub struct Breakfast {//结构体成员默认是私有的pub toast: String,pub seasonal_fruit: String,}impl Breakfast {pub fn summer(toast: &str) -> Breakfast {Breakfast {toast: String::from(toast),seasonal_fruit: String::from("peaches"),}}}
}pub fn eat_at_restaurant() {// 在夏天点一份黑麦面包作为早餐let mut meal = back_of_house::Breakfast::summer("Rye");// 更改我们想要的面包meal.toast = String::from("Wheat");println!("I'd like {} toast please", meal.toast);meal.seasonal_fruit = String::from("blueberries");let meal2 = back_of_house::Breakfast {toast: String::from("Wheat"),seasonal_fruit: String::from("strawberries"),};
}

模块中枚举的访问规则

mod back_of_house {// 枚举前面加上pub即可pub enum Appetizer {Soup,Salad,}
}pub fn eat_at_restaurant() {let order1 = back_of_house::Appetizer::Soup;let order2 = back_of_house::Appetizer::Salad;
}

模块中use关键字

use关键字将路径引入到作用域中

mod front_of_house {pub mod hosting {pub fn add_to_waitlist() {}}
}//在一个模块里面，也可以直接使用self，use self::front_of_house::hosting;
// 函数：use引用其父亲模块，对于struct和enum则建议全部引入进来
use crate::front_of_house::hosting;pub fn eat_at_restaurant() {hosting::add_to_waitlist();
}
fn main() {}

不同模块定义了相同类型冲突解决办法

// 引入父模块
use std::fmt;
use std::io;fn function1() -> fmt::Result {// --snip--
}fn function2() -> io::Result<()> {// --snip--
}

// 通过重命名解决
#![allow(unused)]
fn main() {
use std::fmt::Result;
use std::io::Result as IoResult;fn function1() -> Result {// --snip--Ok(())
}fn function2() -> IoResult<()> {// --snip--Ok(())
}
}

使用pub use导出本模块的函数给外面模块

mod front_of_house {pub mod hosting {pub fn add_to_waitlist() {}}
}pub use crate::front_of_house::hosting;pub fn eat_at_restaurant() {hosting::add_to_waitlist();
}
fn main() {}

引入外部依赖

使用外部依赖

use rand::Rng;fn main() {let secret_number = rand::thread_rng().gen_range(1..101);
}

模块与子模块

将front_of_house.rs中的子模块hosting定义在另外一个文件中，先创建front_of_house子目录，然后创建hosting.rs文件

模块是可以定义在同级的另外一个文件中的，如上所示，librs的mod front_of_house;

子模块是定义在以父模块为名的目录中的，如上所示，可以在front_of_house.rs模块中使用其子模块hosting.rs。

小结

1。Rust的模块系统概念包括：包package，包装箱crate，模块module和路径path。模块系统的目标是有效组织目录。
2。crate是Rust中的一个编译单元，它可以是一个二机制crate，也可以是一个库crate
3。cargo new缺省创建的是二进制项目，可以通过–bin指定创建二进制项目，或者–Lib~指定创建库项目
4。一个包package可以由一个或者多个crate组成。它包含一个Cargo。toml文件，其中可以定义它所包含的crates
5。一个包最多只能有一个库crate，可以有任意多个二进制crate。但是一个包中必须至少有一个crate。
6。模块类似名字空间，可以逻辑拆分和组织代码。模块用关键字mod定义，模块可以是public也可以是private的。
7。缺省情况下，模块是private私有的，可以添加pub关键字，将一个模块设置为public的。模块中可以嵌套子模块。
8。路径path用于访问一个模块中定义的项。路径可以是相对的，也可以是绝对的。

3.文件内的module

关键字：mod

引入模块中的方法

• usemod名字：方法名
• usemod名字.*
• 写全路径

二、模块化项目结构

·好处

• 使源代码管理更加方便
• 更方便读

1.关于module

默认是private

组成一个module

• File
• Directory，需要mod.rs

2.各个模块之间互相引用

crate根目录引入
super相对路径引入

三、推荐项目结构

bin目录

• 把main.rs放入

somelib

• 需要修改Cargo.toml

[somelib]
name =“somelib"
path=“src/somelib/mod.rs”I  //文件夹
path=“src/somelib/some.rs” //单个文件

1.实例

创建一个项目

创建一个库mlib

• 创建单文件translate模块
• 创建music目录模块
  mp3
  flac
  在flac调用translate模块中的方法
  将flac中的music方法暴露出去

main.rs

fn main() {println!("Hello, world!");mlib::translate::func1();mlib::music::flac::flac();mlib::music::flac::flac_music();mlib::test();mlib::flac_music();
}

src/mlib/music/flac.rs

pub fn flac() {//方法1 调用外层translate.rs里面的方法super::super::translate::func1();println!("flac");
}pub fn flac_music() {// 方法2crate::translate::func1();println!("flac_music");
}

src/mlib/music/mod.rs

// 声明出去pub mod flac;
pub mod mp3;

src/mlib/music/mp3.rs

pub fn mp3() {println!("mp3");
}

src/mlib/mod.rs

// 暴露模块
pub mod music;
pub mod translate;pub fn test() {println!("test....");
}// 暴露模块中的某个函数
pub use music::flac::flac_music;

src/mlib/translate.rs

pub fn func1() {println!("Hello,  func1!");
}

Cargo.toml

[package]
name = "demo"
version = "0.1.0"
edition = "2021"[lib]
name="mlib"
path="src/mlib/mod.rs"[dependencies]

参考

• Rust项目结构