快捷導(dǎo)航

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

更新時(shí)間：2025年04月15日 17:06:22 作者：我是唐青楓

cargo 是 Rust 的構(gòu)建系統(tǒng)和包管理器,負(fù)責(zé)創(chuàng)建項(xiàng)目、編譯代碼、管理依賴(lài)、運(yùn)行測(cè)試等,是日常開(kāi)發(fā)中最常用的工具,這篇文章主要介紹了Rust cargo 命令行工具使用教程,需要的朋友可以參考下

簡(jiǎn)介

cargo 是 Rust 的構(gòu)建系統(tǒng)和包管理器，負(fù)責(zé)創(chuàng)建項(xiàng)目、編譯代碼、管理依賴(lài)、運(yùn)行測(cè)試等，是日常開(kāi)發(fā)中最常用的工具。

創(chuàng)建項(xiàng)目

cargo new project_name      # 創(chuàng)建 binary 項(xiàng)目（可執(zhí)行）
cargo new --lib mylib       # 創(chuàng)建 library 項(xiàng)目（供其它項(xiàng)目調(diào)用）

它會(huì)創(chuàng)建一個(gè)項(xiàng)目結(jié)構(gòu)：

project_name/
├── Cargo.toml        # 項(xiàng)目信息和依賴(lài)配置
└── src/
    └── main.rs       # 項(xiàng)目主入口（lib.rs 對(duì)于庫(kù)）

項(xiàng)目結(jié)構(gòu)和配置文件

Cargo.toml 是項(xiàng)目的核心配置文件，類(lèi)似于 Java 的 pom.xml 或 Node.js 的 package.json：

[package]
name = "my_project"
version = "0.1.0"
edition = "2025"
[dependencies]
rand = "0.8"     # 添加依賴(lài)

常用命令

編譯項(xiàng)目

cargo build          # 構(gòu)建項(xiàng)目（debug 模式）
cargo build --release  # 構(gòu)建 release 模式（優(yōu)化）

運(yùn)行項(xiàng)目

cargo run

帶參數(shù)運(yùn)行

cargo run -- arg1 arg2

檢查語(yǔ)法和錯(cuò)誤（不編譯生成目標(biāo)文件）

cargo check

添加依賴(lài)包

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

安裝 cargo-edit：

cargo install cargo-edit

依賴(lài)管理

在 Cargo.toml 中手動(dòng)添加：

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

添加本地 crate：

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

添加 Git 倉(cāng)庫(kù)依賴(lài)：

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

測(cè)試 & 文檔

測(cè)試

cargo test

生成文檔

cargo doc --open

發(fā)布 Crate 到 crates.io

cargo login                # 登錄 crates.io（需要 token）
cargo publish              # 發(fā)布
cargo package              # 打包并檢查

構(gòu)建配置與工作區(qū)（workspace）

如果有多個(gè) crate 項(xiàng)目組成一個(gè)工程：

根目錄 Cargo.toml 配置：

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

常用 cargo 插件

cargo install cargo-edit         # 管理依賴(lài)（cargo add/remove/etc）
cargo install cargo-watch        # 自動(dòng)監(jiān)控并重編譯
cargo install cargo-audit        # 審計(jì)安全問(wèn)題
cargo install cargo-outdated     # 查看依賴(lài)是否過(guò)期