深入講解下Rust模塊使用方式
前言
本文適用于剛開始學習rust的同學，用于幫助理解rust模塊間是如何相互引用的。本文盡量用極少的代碼來演示，即便之前沒有了解過rust也可以混個眼熟。用的時候可以有個印象。
如果你之前沒有了解過rust，只需要知道：Cargo-依賴管理工具，類似于npm，Cargo 使用文件放置約定，即文件名就是模塊名。crate-集裝箱，是一組功能的封裝，類似于npm包。
本文探討的場景是在項目中對代碼進行不同程度的文件拆分和模塊抽離時，往往需要在一個文件中引入另一個模塊的部分代碼，在javascript中，我們可以通過導入導出來使用其他模塊的代碼，這個過程我們只需要關心導入路徑是否正確。
export const name= xx import lodash from './lodash'
而在rust中，模塊不再通過文件路徑的方式引入，而是通過cargo以及約定的模塊聲明方式來構建模塊樹，然后通過use關鍵字來使用。但是rust的文檔在文件拆分和模塊使用上做的示例不太詳細，于是就參考一些發(fā)布的crate的組織方式進行了梳理。
模塊聲明&使用
假如我們想實現(xiàn)一個加法模塊，并提供給其他地方使用。我們可以有如下三種組織方式
Cargo 使用文件放置約定，因此模塊查找以src目錄下的rs文件或者目錄為準，并且只會查找一級，嵌套文件夾下的rs文件不可以直接被其他文件使用。
方法一：直接在根文件下聲明 add.rs
我們可以通過在src下添加模塊名同名的文件，cargo就可以識別到add模塊。
├── Cargo.lock ├── Cargo.toml ├── src │ ├── add.rs │ ├── lib.rs
方法二：聲明add文件夾，文件夾下包含 mod.rs
如果模塊是文件夾，則必須有mod.rs文件。這類似于javascript的index.js。cargo仍然可以識別到這是add模塊
├── Cargo.lock ├── Cargo.toml ├── src │ ├── add │ │ ├── mod.rs │ ├── lib.rs
假設我們的代碼內容如下,并位于文件add.rs 或者add/mod.rs內
pub fn add_fn(a: i32, b: i32) -> i32 {
a + b
}那么在lib.rs中我們可以通過如下方式調用我們的add模塊
// 聲明模塊并引用模塊內的函數
mod add;
pub use crate::add::add_fn;
pub fn test_lib() {
add_fn(1,2);
}方法三：add.rs和add文件夾同時存在
這種方式的目錄結構看起來像下面這樣
├── Cargo.lock ├── Cargo.toml ├── src │ ├── add │ │ └── add_m.rs │ ├── add.rs // index.js │ ├── lib.rs
add.rs負責入口模塊的導入導出，add文件夾下則存放其余相關聯(lián)的其他模塊。這類似于javascript的index.js統(tǒng)一導出了多個其他模塊。和上面不同的是這里 導入使用到了mod關鍵字來拆分模塊；
文件內容看起來像下面這樣
add.rs
pub mod add_m; // 類似于 export * from './validate; export * from './helper'
add/add_m.rs
pub fn add_fn(a: i32, b: i32) -> i32 {
a + b
}lib.rs
mod add;
pub use crate::add::add_m::add_fn;
pub fn test_lib() {
add_fn(1,2);
}上述三種方式使用較多的應該是前兩種，并且在大型項目內第二種更為合理，可以更好的組織文件。那么當一個模塊文件夾下拆分多個模塊文件時該怎調用相鄰文件呢？
同模塊相鄰文件引用
我們調整目錄結構如下
├── Cargo.lock ├── Cargo.toml ├── src │ ├── add │ │ ├── mod.rs │ │ ├── print.rs │ │ └── user.rs // user會調用print的方法 │ ├── lib.rs
在add模塊下多了print和user。user會調用print的方法。
print.rs
pub mod my_print {
pub fn print_hello() {
println!( hello )
}
}
// 這里的pub mod 可以簡單理解為ts的declare module ，里面是module的可用屬性
// declare module my_print {
// export function print_hello(): string;
// }user.rs
use super::print::my_print;
pub fn hello_user() {
my_print::print_hello();
}
pub struct User {
pub name: String,
}同模塊下的文件互相引用使用super關鍵字。
mod.rs
// mod.rs為入口文件， 下面用mod聲明會先去同文件夾下查找同名文件，如果沒有則看是否有滿足條件 的同名文件夾
// 例如 add 文件夾下沒有print.rs 則查找是否有print文件夾并且文件夾下有mod.rs。
mod print;
mod user;
// 因為是同一個模塊文件夾下，并且在入口文件使用，所以這里應self
pub use self::user::hello_user;
pub use self::user::User;
pub mod add_fn {
// use super::*; 如果有這行，則下面不用每次調用super
pub fn add(a: i32, b: i32) -> i32 {
// 注意這里super關鍵字，因為hello_user是在另一個模塊聲明的，模塊間不能直接調用所以需要使用super來從模塊根進行查找調用
super::hello_user();
let value = super::User {
name: String::from( Rust ),
};
println!( user name {} , value.name);
a + b
}
}
pub fn test_out_ref() {
// 這里不在需要super因為不在mod內定義
hello_user();
}不同模塊引用
我們新增一個模塊multip,返回兩個數相乘的結果，目錄結構如下
├── Cargo.lock ├── Cargo.toml ├── src │ ├── add │ │ ├── mod.rs │ │ ├── print.rs │ │ └── user.rs // user會調用print的方法 │ ├── multip // ------- 新增這個模塊 │ │ ├── mod.rs法 │ ├── lib.rs
multip/mod.rs
pub fn res_multip(a: i32, b: i32) -> i32 {
a * b
}假設add文件引入multip
mod print; mod user; pub use self::user::hello_user; pub use self::user::User; // 新增下面這行 use crate::multi::multip;
如此便可以使用另一個模塊的內容了。當然其他模塊的相互引用方式一致。
小結
rust的模塊使用方式總體來說是比較簡單的，由于官方文檔在模塊拆分和組織上并沒有進行較完善的說明，所以對于剛從js轉到rust學習的同學可能會有一點不適應。通過前面內容已經較為清晰的梳理了下使用方式。希望可以對需要的同學有所幫助。
到此這篇關于Rust模塊使用方式的文章就介紹到這了,更多相關Rust模塊使用方式內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
程序在運行的過程中，總是會不可避免地產生錯誤，而如何優(yōu)雅地解決錯誤，也是語言的設計哲學之一。本文就來和大家來了Rust是如何處理錯誤的，感興趣的可以了解一下2023-03-03
rust?的生命周期保證了內存的安全性，同時也增加了開發(fā)者的心智負擔。是在上線之前多費心思寫代碼，還是在上線以后忙忙活活查問題，這是個?trade?off?問題，這篇文章主要介紹了Rust?struct?中的生命周期,需要的朋友可以參考下2022-10-10
這篇文章主要介紹了Rust中的Copy和Clone及區(qū)別對比分析，本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2023-04-04
into_owned是Rust語言中std::borrow::Cow 枚舉的一個方法,into_owned確保了調用者獲得數據的獨立所有權,無論Cow之前是引用還是已經擁有數據,本文給大家介紹Rust 的 into_owned() 方法,感興趣的的朋友跟隨小編一起看看吧2024-03-03
cargo 是 Rust 的構建系統(tǒng)和包管理器,負責創(chuàng)建項目、編譯代碼、管理依賴、運行測試等,是日常開發(fā)中最常用的工具,這篇文章主要介紹了Rust cargo 命令行工具使用教程,需要的朋友可以參考下2025-04-04
Rust中使用Rhai動態(tài)調用字符串定義的函數,通過eval_expression_with_scope實現(xiàn),但參數傳遞和函數名處理有局限性,使用FnCall功能更健壯,但更復雜,總結提供了更通用的方法,但需要處理更多錯誤情況2025-02-02
在Rust中,trait定義了一組方法,這些方法可以被一個或多個類型實現(xiàn),當你為某個類型實現(xiàn)一個trait時,你可以為該trait中的每個方法提供自己的具體實現(xiàn),本文將給大家介紹一下trait中的個方法是否可以重寫,需要的朋友可以參考下2023-10-10
這篇文章主要為大家介紹了rust交叉編譯問題及報錯解析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2023-07-07
這篇文章主要介紹了Rust中自定義Debug調試輸出的示例詳解,本文給大家介紹的非常詳細,感興趣的朋友跟隨小編一起看看吧2024-12-12
Rust作者認為變量默認應該是immutable,即聲明后不能被改變的變量,這一點是讓跨語言學習者覺得很別扭,不過這一點小的改變帶來了諸多好處,本節(jié)我們來學習Rust中不可變變量與const的區(qū)別,需要的朋友可以參考下2024-02-02