README.md

title	tags
Cargo	Rust basic wtfacademy

WTF Rust 极简入门: Cargo 管理

在本章中，我们将讨论如何使用 Rust 的包管理工具 Cargo 来管理项目依赖。我们将首先探讨 Cargo 的基本功能，然后深入研究如何添加、更新和管理外部库依赖项。最后，我们会介绍一些 Cargo 的高级功能，如如何使用工作空间管理多个包。

理解Cargo

Cargo是 Rust 的官方包管理工具（使用 rustup 安装 Rust 时，会默认安装 Cargo），负责多方面的任务：创建和管理 rust 模块系统、下载并编译依赖库、构建软件包等。它还能够确保所有依赖项的版本兼容性，让项目构建更可靠。可以使用以下命令检查Cargo是否安装以及查看Cargo版本：

cargo --version

初始化项目

要开始使用 Cargo 管理 Rust 项目，首先需要创建一个 Cargo 配置文件（Cargo.toml）。这个文件描述了项目的基本信息和依赖。使用命令cargo new <project_name>能够快速生成一个新的项目目录，里面包含了基本的项目结构和Cargo.toml文件。

cargo new project_name

运行项目

使用 cargo new 创建项目后，可以使用 cargo run 命令来编译并运行项目。如果项目已完成编译，Cargo 会直接运行二进制文件。

cd project_name
cargo run

添加和管理依赖

1. 手动添加

在Cargo.toml文件中，你可以在[dependencies]节下添加所需的库依赖。Cargo支持从crates.io（Rust的官方包仓库）、GitHub或本地路径等多种来源获取依赖。

假设你想要添加一个名为"serde"的序列化库，你可以在Cargo.toml的[dependencies]节下添加以下代码：

[dependencies]
serde = "1.0"

然后运行cargo build，Cargo会自动下载并编译 serde 及其依赖。

2. 使用cargo add

除了以上手动添加的方式外，我们也可以使用 cargo add 依赖名称 来快速添加所需要的依赖。

cargo add serde

使用 Cargo 的工作空间

对于包含多个包的大型项目，使用 Cargo 的工作空间功能能够高效管理依赖与构建。工作空间由一个顶层的Cargo.toml配置文件定义，它链接到多个子项目。

创建工作空间

在工作空间的根目录的Cargo.toml中，你可以如下配置子包：

[workspace]
members = [
    "crate1",
    "crate2",
]

每个成员目录都有自己的Cargo.toml文件和源代码。这样设置后，Car工作空间中的所有包能共享依赖，提高编译效率。

高级功能

特性标志

Cargo支持通过特性标志来启用或禁用代码中的特定功能。这在需要可选功能的情况下非常有用。

Cargo插件

Cargo支持使用第三方插件来扩展其功能，例如cargo-edit可以直接在命令行中添加、更新和删除依赖。

通过这一章的学习，你应该对如何使用 Cargo 来管理 Rust 项目的依赖有了全面的了解。掌握这些知识将帮助你更高效地开发 Rust 应用。