Rust cargo 命令行工具使用教程

简介

cargo 是 Rust 的构建系统和包管理器,负责创建项目、编译代码、管理依赖、运行测试等,是日常开发中最常用的工具。

创建项目

shell 复制代码
cargo new project_name      # 创建 binary 项目(可执行)
cargo new --lib mylib       # 创建 library 项目(供其它项目调用)

它会创建一个项目结构:

shell 复制代码
project_name/
├── Cargo.toml        # 项目信息和依赖配置
└── src/
    └── main.rs       # 项目主入口(lib.rs 对于库)

项目结构和配置文件

Cargo.toml 是项目的核心配置文件,类似于 Java 的 pom.xml 或 Node.js 的 package.json:

toml 复制代码
[package]
name = "my_project"
version = "0.1.0"
edition = "2025"

[dependencies]
rand = "0.8"     # 添加依赖

常用命令

编译项目

shell 复制代码
cargo build          # 构建项目(debug 模式)
cargo build --release  # 构建 release 模式(优化)

运行项目

shell 复制代码
cargo run

带参数运行

shell 复制代码
cargo run -- arg1 arg2

检查语法和错误(不编译生成目标文件)

shell 复制代码
cargo check

添加依赖包

shell 复制代码
cargo add serde        # 需要安装 cargo-edit 插件

安装 cargo-edit:

shell 复制代码
cargo install cargo-edit

依赖管理

在 Cargo.toml 中手动添加:

toml 复制代码
[dependencies]
serde = "1.0"
reqwest = { version = "0.11", features = ["json"] }

添加本地 crate:

toml 复制代码
[dependencies]
mycrate = { path = "../mycrate" }

添加 Git 仓库依赖:

toml 复制代码
[dependencies]
mycrate = { git = "https://github.com/user/mycrate.git" }

测试 & 文档

测试

shell 复制代码
cargo test

生成文档

shell 复制代码
cargo doc --open

发布 Crate 到 crates.io

shell 复制代码
cargo login                # 登录 crates.io(需要 token)
cargo publish              # 发布
cargo package              # 打包并检查

构建配置与工作区(workspace)

如果有多个 crate 项目组成一个工程:

根目录 Cargo.toml 配置:

toml 复制代码
[workspace]
members = [
    "core",
    "utils",
    "web"
]

常用 cargo 插件

shell 复制代码
cargo install cargo-edit         # 管理依赖(cargo add/remove/etc)
cargo install cargo-watch        # 自动监控并重编译
cargo install cargo-audit        # 审计安全问题
cargo install cargo-outdated     # 查看依赖是否过期

命令速查表

  • cargo new: 创建项目

  • cargo build:编译项目

  • cargo run:编译并运行

  • cargo check:检查代码是否可编译

  • cargo test:运行测试

  • cargo doc --open:生成并打开文档

  • cargo add xxx:添加依赖(需插件)

  • cargo update:更新依赖到最新版本

  • cargo clean:清理构建产物

  • cargo install:安装二进制 crate(如 ripgrep)

相关推荐
SomeOtherTime4 小时前
第 11 讲(大结局):编译期元编程与零拷贝架构——卫生声明宏(macro_rules!)、过程宏 AST 手术刀与 Serde 零反射序列化的终极合龙
rust
SomeOtherTime9 小时前
番外篇(第 12 讲):走向工业界深水区——从物理定律看 Rust 在真实工程中的“降维打击”与“阿喀琉斯之踵”
开发语言·rust
Kapaseker10 小时前
Rust 桌面开发到底怎么选?先看这篇文章!
rust
奶油话梅糖11 小时前
容器启停 2.5 毫秒:11 天 1,700 Star 的 Kiri,用一个 900 KB 的 PID 1 干掉了 runc 和 dockerd
前端·人工智能·rust
wflynn1 天前
GitHub 今日推荐|kiri:clone3 系统调用直达容器,2.5 毫秒启动无 runc 中间层
docker·rust·kubernetes·开源·github·containers
SomeOtherTime1 天前
第 4 讲:突破静态枷锁——智能指针(Box/Rc/Arc)与内部可变性(Cell/RefCell/UnsafeCell)的内存暗道
rust
SomeOtherTime1 天前
第 9 讲:异步并发与 Pin 的底层解剖——async/await 无栈协程状态机脱糖、自引用死锁的终极救赎与 Future/Waker 驱动模型
rust
wflynn2 天前
GitHub 今日推荐|Stela:在 PC 上直接启动 macOS 的翻译层
rust·开源·github
aifannihao2 天前
Rust 1.100 的 DropGuard:用 Python 实测失败回滚与吞异常
python·rust·异常处理·标准库·contextlib
鶴哥只手遮天2 天前
《rustc 内幕》第 1 章 全景:rustc 编译流水线与 crate 版图
后端·rust·开源