Rust 的构建系统和包管理器
Rust 的构建系统和包管理器
什么是Cargo
Cargo 是 Rust 官方提供的构建系统和包管理器,是 Rust 生态的核心工具之一。它不仅能自动化处理项目的编译、链接等构建流程,还能管理依赖、运行测试、生成文档、发布包等,极大简化了 Rust 项目的开发和维护。
Cargo的核心功能
- 构建自动化:它可以自动处理编译顺序、链接依赖等复杂流程。
- 依赖管理:统一管理项目依赖的第三方库。
安装Cargo
如果你安装了Rust,一般Cargo也安装好了,输入以下命令看看Cargo是否安装:
cargo --version
如果安装成功如下图所示:

如果没安装,请重新用Rustup安装。
用Cargo构建一个项目
- 输入以下命令构建Cargo项目:
cargo new <name>

生成的代码结构如下图所示:

它初始化了一个新的 Git 存储库以及一个 .gitignore 文件。如果您在现有 Git 存储库中运行 cargo new,则不会生成 Git 文件;您可以使用 cargo new --vcs=git 覆盖此行为。
- 打开Cargo.toml文件如下图所示:

Cargo的配置格式为toml`
[package]表示是一个节标题,指示以下语句正在配置包。
接下来的三行设置了 Cargo 编译程序所需的配置信息:名称、版本和要使用的 Rust 版本。
[dependencies] 是一个部分的开头,供您列出任何 项目的依赖项。
- src/main.rs

Cargo 自动生成了一个 “Hello, world!” 程序,源文件一般都放在src目录下。
编译和运行Cargo项目
在控制台中输入以下命令编译项目,并生成可执行文件:
cargo build

生成的可执行文件在 *target\debug\*中
再在控制台中输入 以下命令,执行可执行文件:
.\target\debug\HelloCargo.exe

也可以直接使用以下命令直接编译运行可执行文件:
cargo run

现在你就会使用cargo构建项目以及编译运行了。
Cargo的命令
| 命令 | 作用 |
|---|---|
cargo new <name> | 创建新二进制项目(默认生成 src/main.rs) |
cargo new <name> --lib | 创建新库项目(生成 src/lib.rs) |
cargo build | 编译项目(默认生成调试模式产物,位于 target/debug/) |
cargo build --release | 编译发布模式产物(优化编译,位于 target/release/) |
cargo run | 编译并运行项目(等价于 cargo build && ./target/debug/<name>) |
cargo run -- <args> | 运行项目并传递命令行参数(如 cargo run -- --help) |
cargo check | 快速检查代码是否有错误(不生成二进制,比 build 快) |
cargo test | 运行所有测试(单元测试、集成测试、文档测试) |
cargo doc | 生成项目文档(包括依赖的文档,位于 target/doc/) |
cargo doc --open | 生成文档并自动在浏览器打开 |
cargo update | 根据 Cargo.toml 的版本约束更新依赖(更新 Cargo.lock) |
cargo clean | 清理构建产物(删除 target/ 目录) |
赖(更新 Cargo.lock) | |
cargo clean | 清理构建产物(删除 target/ 目录) |
cargo publish | 将库发布到 crates.io(Rust 中央包仓库) |
