概述

在Rust生態(tài)系統(tǒng)中，Cargo扮演著至關(guān)重要的角色，它是官方的構(gòu)建系統(tǒng)和包管理器。Cargo簡(jiǎn)化了項(xiàng)目的構(gòu)建過(guò)程，提供了依賴項(xiàng)管理，以及一系列方便的工作流程工具，極大提升了開發(fā)效率和協(xié)作體驗(yàn)。

新建項(xiàng)目

新建Rust項(xiàng)目時(shí)，首先使用cargo new命令：cargo new my_project。這將在當(dāng)前目錄下生成一個(gè)名為my_project的目錄，其中包括源碼文件夾src、項(xiàng)目配置文件Cargo.toml等。Cargo.toml是Rust項(xiàng)目的核心配置文件，由TOML格式編寫，用于描述項(xiàng)目的基本信息、依賴項(xiàng)以及其他項(xiàng)目特定的配置。

[package]
name = "hello_rust"
version = "0.1.0"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

添加依賴

要在項(xiàng)目中添加依賴，只需在Cargo.toml中指定庫(kù)名和版本即可。執(zhí)行cargo build或cargo run命令后，Cargo會(huì)自動(dòng)解析依賴關(guān)系，下載所需的依賴包，并編譯項(xiàng)目的源代碼。構(gòu)建完成后，可以在target/debug或target/release目錄下找到生成的可執(zhí)行文件或庫(kù)文件。

[dependencies]
rand = "0.8" # 添加隨機(jī)數(shù)生成庫(kù)rand，版本號(hào)為0.8
clap = "3.0"

添加測(cè)試

Cargo內(nèi)置了測(cè)試框架，我們可以編寫測(cè)試代碼來(lái)驗(yàn)證項(xiàng)目的正確性。在Rust項(xiàng)目中，測(cè)試文件通常放在tests目錄下，并以_test.rs為后綴。比如：可以創(chuàng)建一個(gè)名為project_test.rs的測(cè)試文件，并編寫以下測(cè)試代碼。

fn add(a: i32, b: i32) -> i32 {
    return a + b;
}

#[test]
fn test_add() {
    assert_eq!(add(2, 3), 5);
    assert_eq!(add(-1, 1), 0);
}

在Rust中，#[test]是一個(gè)屬性宏，用于標(biāo)識(shí)一個(gè)函數(shù)為測(cè)試函數(shù)。當(dāng)運(yùn)行cargo test命令時(shí)，Rust會(huì)自動(dòng)執(zhí)行所有標(biāo)記了#[test]屬性的函數(shù)，用于驗(yàn)證代碼的正確性。

工作空間

在Rust中，工作空間是一種組織多個(gè)相關(guān)Cargo項(xiàng)目的結(jié)構(gòu)。工作空間允許我們?cè)谝粋€(gè)頂級(jí)的Cargo.toml文件下管理多個(gè)庫(kù)和可執(zhí)行程序項(xiàng)目，便于共享依賴項(xiàng)、統(tǒng)一構(gòu)建配置以及更好地組織項(xiàng)目結(jié)構(gòu)。

要?jiǎng)?chuàng)建一個(gè)Rust工作空間，首先在根目錄下創(chuàng)建一個(gè)頂級(jí)的Cargo.toml文件，并在其中加入[workspace]配置節(jié)。

# Cargo.toml (頂級(jí)工作空間配置文件)
[workspace]
members = [
    "crate1",
    "crate2",
    "bin1",
]

在上述配置中：[workspace]表明這是一個(gè)工作空間，members列表包含了工作空間中的成員項(xiàng)目，它們是相對(duì)于此頂級(jí)Cargo.toml文件的路徑。每個(gè)成員項(xiàng)目（比如：crate1、crate2、bin1）都有自己的Cargo.toml文件，可以獨(dú)立地定義自己的依賴項(xiàng)和構(gòu)建目標(biāo)。然而，共享的依賴項(xiàng)和配置將從頂級(jí)工作空間的Cargo.toml繼承。

以crate1項(xiàng)目為例，其結(jié)構(gòu)可能如下。

root_workspace/
├── Cargo.toml (頂級(jí)工作空間配置)
├── crate1/
│   ├── Cargo.toml (crate1的配置)
│   └── src/
│       └── lib.rs
├── crate2/
│   ├── Cargo.toml (crate2的配置)
│   └── src/
│       └── lib.rs
└── bin1/
    ├── Cargo.toml (bin1的配置，一個(gè)可執(zhí)行項(xiàng)目)
    └── src/
        └── main.rs

在這樣的工作空間中，我們可以通過(guò)cargo test、cargo build或cargo run等命令在頂層目錄執(zhí)行操作。Cargo將會(huì)遍歷所有成員項(xiàng)目，并執(zhí)行相應(yīng)的構(gòu)建或測(cè)試任務(wù)。

文檔生成

在Rust中，用于生成文檔的標(biāo)準(zhǔn)工具是rustdoc，它是Rust編譯器的一部分。rustdoc不僅可以提取代碼中的注釋來(lái)生成API文檔，還支持編寫Markdown和一些特殊的Rustdoc標(biāo)記來(lái)豐富文檔內(nèi)容。

要為Rust項(xiàng)目生成文檔，可按照以下步驟操作。

1、在Rust源代碼中，使用///開始的三斜杠注釋來(lái)編寫函數(shù)、模塊、結(jié)構(gòu)體、枚舉等的文檔注釋。

/// This is an example of a library function.
///
/// # Example
///
/// ```
/// use my_crate::print_text;
///
/// print_text("CSDN");
/// ```
pub fn print_text(text: &str) {
    println!("{}", format!("{} CSDN", text));
}

fn main() {
    print_text("Hello");
}

2、打開終端，導(dǎo)航到項(xiàng)目的根目錄（包含Cargo.toml的地方），然后運(yùn)行：cargo doc。這個(gè)命令會(huì)編譯項(xiàng)目并為所有公共接口生成文檔，輸出結(jié)果默認(rèn)位于target/doc目錄下。打開target/doc/<crate_name>/index.html文件，即可查看生成的文檔。

3、如果要在本地啟動(dòng)一個(gè)Web服務(wù)器實(shí)時(shí)預(yù)覽文檔，可在生成文檔后執(zhí)行：cargo doc --open，這樣rustdoc將自動(dòng)在瀏覽器中打開文檔索引頁(yè)。

Cargo構(gòu)建和編譯項(xiàng)目Cargo build、Cargo run、

PS E:\100rust\hello_world> cargo build
   Compiling hello_world v0.1.0 (E:\100rust\hello_world)
    Finished dev [unoptimized + debuginfo] target(s) in 1.48s

Cargo build會(huì)自動(dòng)構(gòu)建項(xiàng)目，自動(dòng)創(chuàng)建一個(gè)target文件夾，文件夾包含編譯后的文件：

可以看到里面有個(gè)hello_world.exe文件，此時(shí)可以直接調(diào)用它，成功運(yùn)行后輸出helloworld。

但是，我們可以使用Cargo run來(lái)一鍵編譯且運(yùn)行：

Cargo check僅編譯項(xiàng)目

有一個(gè)常會(huì)遇到的場(chǎng)景是，我在編程序時(shí)只想檢查項(xiàng)目，但并不想生成可執(zhí)行文件，我的目的是確保沒有錯(cuò)誤或者bug。因?yàn)?，通常編譯且生成可執(zhí)行文件，需要的時(shí)間會(huì)大于僅編譯檢查的時(shí)間，所以使用Cargo check會(huì)更快，如果你使用Cargo run當(dāng)然也是可行的，但我相信你不會(huì)這么做。

以上是一個(gè)簡(jiǎn)單但完整的項(xiàng)目構(gòu)成的過(guò)程，使用Cargo在hello world這樣的項(xiàng)目中似乎有點(diǎn)大材小用，但Cargo是為了你構(gòu)建大型項(xiàng)目準(zhǔn)備的，你應(yīng)該在學(xué)習(xí)Rust的初期，就直接使用Cargo，這對(duì)你以后管理rust項(xiàng)目非常重要。

當(dāng)然，Cargo的指令遠(yuǎn)不止以上那些。

   build, b    Compile the current package
    check, c    Analyze the current package and report errors, but don't build object files
    clean       Remove the target directory
    doc, d      Build this package's and its dependencies' documentation
    new         Create a new cargo package
    init        Create a new cargo package in an existing directory
    add         Add dependencies to a manifest file
    remove      Remove dependencies from a manifest file
    run, r      Run a binary or example of the local package
    test, t     Run the tests
    bench       Run the benchmarks
    update      Update dependencies listed in Cargo.lock
    search      Search registry for crates
    publish     Package and upload this package to the registry
    install     Install a Rust binary. Default location is $HOME/.cargo/bin
    uninstall   Uninstall a Rust binary

如Cargo clean，將清除target文件夾。

總結(jié)

通過(guò)以上的介紹，我們可以看到Cargo在Rust項(xiàng)目中的重要作用。它不僅簡(jiǎn)化了構(gòu)建和分發(fā)過(guò)程，還提供了豐富的功能和靈活的擴(kuò)展性。無(wú)論是初學(xué)者還是經(jīng)驗(yàn)豐富的開發(fā)者，都可以通過(guò)Cargo來(lái)更加高效地創(chuàng)建、測(cè)試、文檔化和分享自己的Rust項(xiàng)目。

到此這篇關(guān)于深入理解Rust中Cargo的使用的文章就介紹到這了,更多相關(guān)Rust Cargo內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論