Cargo 入门

发现宝藏

前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。【宝藏入口】。

1. 安装 Cargo

Cargo 随 Rust 一起安装，因此如果你已经安装了 Rust，那么你也已经安装了 Cargo。你可以通过以下命令来验证 Cargo 是否安装成功：

cargo --version

这将输出 Cargo 的版本信息，例如：

cargo 1.70.0 (c5f3c0e5f 2023-07-10)

2. 创建一个新项目

Cargo 可以快速创建和管理 Rust 项目。以下是创建新项目的步骤：

1.1.打开终端

打开你的终端或命令提示符。

1.2. 创建新项目

使用以下命令创建一个新的 Rust 项目：

cargo new my_project

这会创建一个名为 my_project 的目录，其中包含一个基本的 Rust 项目结构。

1.3. 进入项目目录

cd my_project

1.4. 查看项目结构

在项目目录中，你会看到如下结构：

my_project/
├── Cargo.toml
└── src/
    └── main.rs

• Cargo.toml：项目的配置文件，定义了项目的元数据和依赖项。
• src/main.rs：Rust 源代码文件，包含项目的入口点。

3. 构建和运行项目

Cargo 使得构建和运行 Rust 项目变得非常简单：

3.1. 构建项目

cargo build

这将编译你的 Rust 项目，并将生成的可执行文件放在 target/debug/ 目录下。

3.2. 运行项目

cargo run

这会自动构建项目（如果尚未构建），并运行生成的可执行文件。你会看到输出：

Hello, world!

4. 管理依赖

Cargo 使得添加和管理项目依赖变得非常简单。你可以在 Cargo.toml 文件中指定你的依赖项。以下是一个示例：

4.1. 编辑 Cargo.toml

打开 Cargo.toml 文件，添加依赖项。例如，添加 serde 库（一个流行的序列化/反序列化库）：

[dependencies]
serde = "1.0"

4.2. 安装依赖

运行以下命令来下载和编译依赖：

cargo build

Cargo 会自动下载并编译 serde 库及其依赖。

4.3. 在代码中使用依赖

在你的 src/main.rs 文件中，你可以使用 serde 库：

use serde::Serialize;

#[derive(Serialize)]
struct MyStruct {
    field: String,
}

fn main() {
    let my_instance = MyStruct {
        field: String::from("Hello, Cargo!"),
    };
    println!("{:?}", my_instance);
}

5. 运行测试

Cargo 提供了内置的测试支持，可以很方便地运行测试：

5.1. 编写测试

在 src/main.rs 文件中，你可以添加测试模块：

#[cfg(test)]
mod tests {
    #[test]
    fn it_works() {
        assert_eq!(2 + 2, 4);
    }
}

5.2. 运行测试

运行以下命令来执行所有测试：

cargo test

你会看到测试结果的输出，如果所有测试都通过，会显示：

test tests::it_works ... ok

6. 管理工作区

Cargo 支持工作区（Workspace），允许你管理多个相关的包。以下是设置工作区的步骤：

6.1. 创建工作区目录

创建一个新的目录并进入：

mkdir my_workspace
cd my_workspace

6.2. 创建工作区配置文件

在工作区目录中创建一个 Cargo.toml 文件：

[workspace]
members = [
    "package1",
    "package2",
]

6.3. 添加包

创建子目录 package1 和 package2，并在每个子目录中创建 Cargo.toml 文件：

cargo new package1
cargo new package2

6.4. 构建和运行工作区

在工作区目录中，你可以使用 cargo build 或 cargo run 来构建和运行整个工作区。

7. 使用 Cargo 插件

Cargo 也支持插件（称为 Cargo subcommands），例如 cargo-clippy 用于静态分析代码，cargo-fmt 用于代码格式化等。

7.1. 安装插件

例如，安装 cargo-clippy：

cargo install clippy

7.2. 使用插件

运行 cargo clippy 来分析你的代码：

cargo clippy

Cargo 是 Rust 的强大工具，它简化了项目管理、依赖管理、构建和测试过程。通过掌握 Cargo 的使用，你可以更加高效地开发 Rust 应用程序。希望这篇博客对你了解和使用 Cargo 有所帮助！如果你有更多问题，可以查阅官方文档或参与社区讨论。