欢迎来到尧图网

客户服务 关于我们

您的位置:首页 > 教育 > 锐评 > rust 中的package、crate、module

rust 中的package、crate、module

2025/11/10 23:55:05 来源:https://blog.csdn.net/yinhezhanshen/article/details/146247395  浏览:    关键词:rust 中的package、crate、module

初学rust,对crate和mod的使用总是感到不太顺利,特此记录一下。

当我们用cargo 创建一个新项目时,默认就创建了一个package。

PS D:\test\rust_test> cargo new myproject
    Creating binary (application) `myproject` package
note: see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
PS D:\test\rust_test> 

crate:一个模块的树形结构,它形成了库或二进制项目。

module:一个 module 是用来组织代码的逻辑单位,用于拆分一个 crate 中的代码。

大致关系如下:

  • 1个Package里,至少要有1种Crate(要么是Library Crate,要么是Binary Crate)
  • 1个Package里,最多只能有1个Library Crate
  • 1个Package里,可以有0或多个Binary Crate
  • 1个Crate里,可以创建0或多个mod

场景一

先看一个最简单的例子:

mod database{pub fn mysql(){println!("I am mysql"); }
}fn main() {database::mysql();
}

 运行:

PS D:\test\rust_test\myproject> cargo run
   Compiling myproject v0.1.0 (D:\test\rust_test\myproject)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.59s
     Running `target\debug\myproject.exe`
I am mysql

说明:

1、需要加pub关键字将模块内的函数mysql()公开,否则main函数发现不到mysql()的存在。

2、main函数调用mysql时需要加上模块名称,database::mysql()。否则编译器也找不到mysql()。

场景二

再来看一个复杂点的例子:

mod database{pub fn mysql(){println!("I am mysql"); }pub mod action{pub fn action_mysql(){super::mysql();     //子模块调用父模块,加super} }pub fn print_mysql(){mysql();}
}fn main() {database::print_mysql();use database::action;      //使用use简化调用路径action::action_mysql();
}

运行:

PS D:\test\rust_test\myproject> cargo run
   Compiling myproject v0.1.0 (D:\test\rust_test\myproject)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.17s
     Running `target\debug\myproject.exe`
I am mysql
I am mysql

说明:

1、可以使用use关键字简化路径。

2、子模块调用父模块时,要加super关键字。

场景三

再来看一下多目录,多文件的场景:

在src目录下建立两个目录,folder_a和folder_b,然后folder_a下创建文件a1.rs, folder_b下创建文件b1.rs。目录结构看起来是下面这个样子的:

├─src
│  │  main.rs
│  ├─folder_a
│  │      a1.rs
│  └─folder_b
│          b1.rs

a1.rs内容如下:

pub mod inner{pub fn action_a1(){println!("action_a1");}
}

b1.rs内容如下:

pub mod b1{pub fn action_b1(){println!("action_b1");}
}

那么main.rs如何才能调用到action_a1()和action_b1()呢?需要做如下操作:

1、在src目录下新建三个文件,分别是lib.rs, folder_a.rs, folder_b.rs。

├─src
│  │  folder_a.rs
│  │  folder_b.rs
│  │  lib.rs
│  │  main.rs
│  ├─folder_a
│  │      a1.rs
│  └─folder_b
│          b1.rs

lib.rs内容如下:

pub mod folder_a;
pub mod folder_b;

 folder_a.rs内容如下:

pub mod a1;

 folder_b.rs内容如下:

pub mod b1;

2.修改main.rs文件

use myproject::folder_a;   //myproject为Cargo.toml里面的package name
use myproject::folder_b;fn main() {folder_a::a1::inner::action_a1();folder_b::b1::b1::action_b1();       //两个b1, 第一个b1把b1.rs认为一个mod,第二个b1是pub mod b1{}
}

 运行成功!

PS D:\test\rust_test\myproject> cargo run
   Compiling myproject v0.1.0 (D:\test\rust_test\myproject)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.50s
     Running `target\debug\myproject.exe`
action_a1
action_b1

版权声明:

本网仅为发布的内容提供存储空间,不对发表、转载的内容提供任何形式的保证。凡本网注明“来源:XXX网络”的作品,均转载自其它媒体,著作权归作者所有,商业转载请联系作者获得授权,非商业转载请注明出处。

我们尊重并感谢每一位作者,均已注明文章来源和作者。如因作品内容、版权或其它问题,请及时与我们联系,联系邮箱:809451989@qq.com,投稿邮箱:809451989@qq.com

热搜词