1. 简介

Cargo 是 Rust 的构建系统和包管理器,大多数 Rustacean 们使用 Cargo 来管理他们的 Rust 项目,因为它可以处理很多任务,比如构建代码、下载依赖库(在 Rust 中称为「crate」)并编译这些库。

2. 使用 Cargo

2.1 创建项目

Cargo 工具创建项目的基本语法格式如下:

1
cargo new <project>

运行上述命令后,会创建一个名为 <project> 的目录,并初始化该目录为一个仓库,其目录结构如下:

1
2
3
4
5
6
.
├── .git
├── .gitignore
├── Cargo.toml
└── src
└── main.rs
  • Cargo.toml 为当前项目的 Cargo 配置文件,采用的是 TOML 文件格式。

2.2 构建项目

Cargo 工具构建项目的基本语法格式如下:

1
2
# 在项目目录下执行
cargo build

运行上述构建命令后,会在项目目录下生成一个 target 目录,该目录下的 debug 目录中包含了一些编译文件和生成的可执行文件等信息。

【注】当项目最终准备好发布时,可以使用 cargo build --release 来优化编译项目。这会在 target/release 下而不是 target/debug 下生成可执行文件。

这些优化可以让 Rust 代码运行的更快,不过启用这些优化也需要消耗更长的编译时间。这也就是为什么会有两种不同的配置:一种是为了开发,你需要经常快速重新构建;另一种是为用户构建最终程序,它们不会经常重新构建,并且希望程序运行得越快越好。

2.3 运行项目

Cargo 工具运行项目的基本语法格式如下:

1
2
# 在项目目录下执行
cargo run

运行上述运行命令后,会运行构建过程生成的可执行文件 ./target/debug/<project>

【注】如果没有构建项目直接运行 cargo run,Cargo 会先自动构建项目然后运行程序。

2.4 检查代码

Cargo 工具还提供了快速检查项目代码确保其可以编译的功能,其基本语法格式如下:

1
2
# 在项目目录下执行
cargo check

cargo checkcargo build 快得多,因为它省略了生成可执行文件的步骤。因此在编写代码时只是想持续的进行代码检查,cargo check 是一个不错的选择。

2.5 查看文档

当我们在调用依赖库(crate)时,我们不知道应该从 crate 中调用那个方法,crate 的使用说明位于其文档中,所以我们需要查阅相关文档。而 Cargo 有一个很棒的功能是:运行 cargo doc --open 命令来构建所有本地依赖提供的文档,并在浏览器中打开。

附录

关于 Cargo 工具更详细的介绍参考其官方文档: