Rust cargo 命令行工具使用示例教程

胡竹林 · 发表于 2025-4-15 17:06:22

简介

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

创建项目

cargo new project_name      # 创建 binary 项目（可执行）
cargo new --lib mylib       # 创建 library 项目（供其它项目调用）

它会创建一个项目结构：

project_name/
├── Cargo.toml        # 项目信息和依赖配置
└── src/
    └── main.rs       # 项目主入口（lib.rs 对于库）

项目结构和配置文件

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

[package]
name = "my_project"
version = "0.1.0"
edition = "2025"
[dependencies]
rand = "0.8"     # 添加依赖

常用命令

编译项目

cargo build          # 构建项目（debug 模式）
cargo build --release  # 构建 release 模式（优化）

运行项目

cargo run

带参数运行

cargo run -- arg1 arg2

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

cargo check

添加依赖包

cargo add serde        # 需要安装 cargo-edit 插件

安装 cargo-edit：

cargo install cargo-edit

依赖管理

在 Cargo.toml 中手动添加：

[dependencies]
serde = "1.0"
reqwest = { version = "0.11", features = ["json"] }

添加本地 crate：

[dependencies]
mycrate = { path = "../mycrate" }

添加 Git 仓库依赖：

[dependencies]
mycrate = { git = "https://github.com/user/mycrate.git" }

测试 & 文档

测试

cargo test

生成文档

cargo doc --open

发布 Crate 到 crates.io

cargo login                # 登录 crates.io（需要 token）
cargo publish              # 发布
cargo package              # 打包并检查

构建配置与工作区（workspace）

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

根目录 Cargo.toml 配置：

[workspace]
members = [
    "core",
    "utils",
    "web"
]

常用 cargo 插件

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）

到此这篇关于Rust cargo 命令行工具使用教程的文章就介绍到这了,更多相关Rust cargo 命令行工具内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！

您可能感兴趣的文章:

使用cargo install安装Rust二进制工具过程
rust 如何使用 cargo-nextest 替代 cargo test
深入理解Rust中Cargo的使用
Rust中Cargo的使用详解
Rust中的Cargo构建、运行、调试
使用Cargo工具高效创建Rust项目
Rust处理命令行参数
利用rust实现一个命令行工具
如何在Rust中处理命令行参数和环境变量

[教程] Rust cargo 命令行工具使用示例教程

目录

简介