第2章 Cargo与项目管理

2. Cargo与项目管理：从零开始掌控你的Rust项目

聊到Rust，就绕不开Cargo。说实话，Cargo是我见过最省心的构建工具之一。你想想看，在C语言里配个Makefile都能让人抓狂，而Rust这边，一个cargo new就全搞定了。我个人习惯是，不管项目多小，都用Cargo来管理——哪怕只是写个测试脚本。

2.1 Cargo创建项目：三秒搭好脚手架

创建新项目，就一行命令：

cargo new my_project
cd my_project

这会在当前目录下生成一个my_project文件夹，里面包含：

Cargo.toml —— 项目的“身份证”，所有元信息都写在这
src/main.rs —— 入口文件，默认打印"Hello, world!"
.gitignore —— 自动帮你把target/目录忽略掉

如果你想建一个库项目（而不是可执行程序），加个--lib参数就行：

cargo new my_lib --lib

这时候生成的是src/lib.rs，而不是main.rs。我在项目中经常这样干——先建一个库，然后在别的项目里引用它，后面讲工作空间时你会看到这种模式有多爽。

小技巧： 如果你在用Git，Cargo会自动初始化仓库。不想这样？加个--vcs none参数。

2.2 Cargo.toml详解：项目的“户口本”

打开Cargo.toml，你会看到类似这样的内容：

[package]
name = "my_project"
version = "0.1.0"
edition = "2021"

[dependencies]

这里每个字段都有讲究：

字段	说明	我的经验
`name`	项目名称，也是crate名	尽量用下划线，别用连字符，否则引用时容易踩坑
`version`	语义化版本号	严格遵循 semver，别乱改主版本号
`edition`	Rust版本（2015/2018/2021）	新项目一律用2021，老项目迁移时再考虑兼容
`authors`	作者信息（可选）	团队项目建议写上，方便追责（笑）

还有一个容易被忽略的字段——[profile.release]。你可以在这里控制编译优化级别：

[profile.release]
opt-level = 3   # 最高优化
lto = true      # 链接时优化
codegen-units = 1  # 单代码生成单元，性能更好

我曾经在一个性能敏感的项目里，靠调整这些参数把程序跑快了30%。嗯，这里要注意，调试时别用release配置，不然报错信息会变得很难看。

2.3 依赖管理：把别人的轮子拿来用

Rust的依赖管理，说白了就是往[dependencies]下面加一行。比如你想用serde做序列化：

[dependencies]
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"

然后代码里直接引用：

use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize)]
struct User {
    name: String,
    age: u8,
}

Cargo会自动去 crates.io 下载依赖，并锁定版本到Cargo.lock文件里。这个文件一定要提交到Git仓库——它能保证所有人用到的依赖版本完全一致。

避坑指南： 我曾经因为没提交Cargo.lock，导致团队成员拉下来的依赖版本不同，编译出来的行为不一致。排查了一整天才发现是依赖版本漂移了。从那以后，我养成了习惯——Cargo.lock必须进版本控制。

依赖还可以指定git仓库或本地路径：

[dependencies]
my_lib = { git = "https://github.com/user/my_lib.git", branch = "main" }
local_lib = { path = "../local_lib" }

本地路径在开发阶段特别有用。我经常把一个大项目拆成多个小crate，用路径依赖互相引用，开发体验非常丝滑。

2.4 Cargo常用命令：每天都要用的那些

这些命令我几乎每天都在用，你最好也记熟：

命令	作用	备注
`cargo build`	编译项目	加`--release`生成优化后的二进制
`cargo run`	编译并运行	开发时最常用
`cargo check`	只检查语法，不生成二进制	比build快很多，写代码时频繁用
`cargo test`	运行测试	支持过滤，比如`cargo test my_test`
`cargo clippy`	代码静态分析	比编译器警告更严格，建议CI里加上
`cargo fmt`	自动格式化代码	团队统一风格的神器
`cargo doc --open`	生成文档并在浏览器打开	检查文档是否写全的好方法

你可能会问：cargo check和cargo build有什么区别？说白了，check只做类型检查，不生成可执行文件。我写代码时习惯开两个终端——一个跑cargo check实时检查，另一个跑编辑器。这样能省下不少编译时间。

  我的工作流： 写代码 → cargo check（快速反馈） → cargo clippy（查漏补缺） → cargo test（确保功能正确） → cargo build --release（最终发布）

2.5 工作空间：管理多crate项目的利器

当项目变大，你会想把代码拆成多个crate。比如一个Web服务，可能有api、db、models三个crate。这时候工作空间就派上用场了。

创建一个工作空间，只需要在根目录放一个Cargo.toml：

[workspace]
members = [
    "api",
    "db",
    "models",
]

目录结构长这样：

my_workspace/
├── Cargo.toml          # 工作空间定义
├── api/
│   ├── Cargo.toml
│   └── src/
│       └── main.rs
├── db/
│   ├── Cargo.toml
│   └── src/
│       └── lib.rs
└── models/
    ├── Cargo.toml
    └── src/
        └── lib.rs

工作空间的好处是：

共享依赖 —— 所有crate共用同一个Cargo.lock和target/目录，编译一次，到处使用
统一命令 —— 在根目录执行cargo build，所有crate一起编译
内部引用方便 —— crate之间可以用路径依赖互相引用

举个例子，api crate想引用models：

# api/Cargo.toml
[dependencies]
models = { path = "../models" }

我曾经接手过一个项目，所有代码都塞在一个crate里，编译一次要5分钟。后来拆成工作空间，每个crate独立编译，改一个模块只需要重新编译那个crate，时间缩短到30秒。你想想看，这效率提升有多明显。

注意： 工作空间里的每个crate仍然可以独立发布到crates.io。只需要在各自的Cargo.toml里加上[package]字段就行。

知识体系总览

下面这张图帮你理清Cargo项目管理的核心脉络：

这张图把Cargo项目管理的几个核心模块串起来了。你从创建项目开始，配置好Cargo.toml，管理好依赖，用常用命令进行开发，最后用工作空间组织大型项目。每一步都有Cargo帮你兜底，你只管写代码就行。

  一句话总结： Cargo不只是构建工具，它是Rust生态的基石。学会用好Cargo，你的Rust开发效率至少提升50%。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录

2. Cargo与项目管理：从零开始掌控你的Rust项目

2.1 Cargo创建项目：三秒搭好脚手架

2.2 Cargo.toml详解：项目的“户口本”

2.3 依赖管理：把别人的轮子拿来用

2.4 Cargo常用命令：每天都要用的那些

2.5 工作空间：管理多crate项目的利器

知识体系总览