Rust Cargo 使用指南#

1️⃣ 创建项目#

1
cargo new myapp
2
cd myapp

1
myapp/
2
├── Cargo.toml   # 项目信息和依赖
3
└── src/
4
    └── main.rs  # 入口文件

1
cargo new mylib --lib

1
mylib/
2
├── Cargo.toml
3
└── src/
4
    └── lib.rs

2️⃣ 构建项目#

1
cargo build       # Debug 模式，默认
2
cargo build --release  # Release 模式，优化编译

1
cargo run

1
cargo build
2
./target/debug/myapp

1
cargo check

3️⃣ 管理依赖#

1
[dependencies]
2
regex = "1.11.0"   # 添加 regex 库

1
cargo add regex

1
cargo update

1
cargo remove regex

4️⃣ 运行测试#

1
#[cfg(test)]
2
mod tests {
3
    #[test]
4
    fn it_works() {
5
        assert_eq!(2 + 2, 4);
6
    }
7
}

1
cargo test

5️⃣ 发布库（Crate）#

1. 登录 crates.io：

1
cargo login <API_TOKEN>

2. 发布：

1
cargo publish

6️⃣ 工作区（Workspace）#

适用于多包项目（比如一个仓库里多个 crate）：

目录结构：

1
myworkspace/
2
├── Cargo.toml      # workspace 配置
3
├── crate1/
4
│   └── Cargo.toml
5
└── crate2/
6
    └── Cargo.toml

workspace Cargo.toml 示例：

1
[workspace]
2
members = ["crate1", "crate2"]

然后可以统一编译：

1
cargo build
2
cargo run -p crate1

7️⃣ 常用 Cargo 命令总结#

8️⃣ 小技巧#

1. 依赖版本写法

   1
   regex = "1.11"     # 1.11.x 最新版本
   2
   regex = "^1.11.0"  # >=1.11.0, <2.0
   

2. 查看依赖树

1
cargo tree

3. 快速运行带参数

1
cargo run -- arg1 arg2