Cargo 简介 #

┌─────────────────────────────────────────────────────────────┐
│                         Cargo                                │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  项目管理    │  │  依赖管理    │  │  构建系统    │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  测试框架    │  │  文档生成    │  │  包发布      │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
└─────────────────────────────────────────────────────────────┘

2011年 ─── Cargo 项目启动
    │
    │      作为 Rust 的配套工具开始开发
    │
2012年 ─── 首次发布
    │
    │      随 Rust 0.1 版本一同发布
    │
2015年 ─── Rust 1.0 发布
    │
    │      Cargo 成为 Rust 官方标准工具
    │      crates.io 正式上线
    │
2016年 ─── 快速发展
    │
    │      增量编译支持
    │      工作区功能
    │
2018年 ─── 成熟稳定
    │
    │      特性标志（Features）
    │      构建脚本增强
    │
2020年 ─── 持续优化
    │
    │      编译缓存共享
    │      依赖解析优化
    │
至今   ─── 生态系统核心
    │
    │      超过 10 万个包
    │      日均下载量超过 1 亿次

# 手动管理依赖
git clone https://github.com/some/dependency.git
cd dependency
make install

# 手动配置编译选项
rustc --opt-level 3 --crate-type lib src/lib.rs

# 手动管理项目结构
mkdir -p src tests examples
# 手动编写 Makefile...

# 一条命令创建项目
cargo new my_project

# 自动管理依赖（编辑 Cargo.toml）
[dependencies]
serde = "1.0"

# 一条命令构建
cargo build --release

# 标准项目结构自动生成
my_project/
├── Cargo.toml
├── src/
│   └── main.rs
├── tests/
└── examples/

# 开发流程
cargo new my_project     # 创建项目
cargo add serde          # 添加依赖
cargo run                # 运行项目
cargo test               # 运行测试
cargo doc                # 生成文档
cargo publish            # 发布包

# Cargo.lock 示例
[[package]]
name = "serde"
version = "1.0.193"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d7371c2a0e6d7e6f6d7b5e5b5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5"

# 内置安全检查
cargo audit              # 检查已知漏洞
cargo tree               # 查看依赖树
cargo outdated           # 检查过时依赖

my_package/
├── Cargo.toml          # 包配置
├── Cargo.lock          # 依赖锁定
├── src/
│   ├── lib.rs          # 库 crate
│   └── main.rs         # 二进制 crate
├── tests/              # 集成测试
├── examples/           # 示例程序
└── benches/            # 性能测试

// src/lib.rs
pub mod network {
    pub mod tcp {
        pub fn connect() { /* ... */ }
    }
    pub mod udp {
        pub fn bind() { /* ... */ }
    }
}

cargo new my_app

my_app/
├── Cargo.toml
└── src/
    └── main.rs      # 程序入口

cargo new my_lib --lib

my_lib/
├── Cargo.toml
└── src/
    └── lib.rs       # 库入口

my_project/
├── Cargo.toml
└── src/
    ├── lib.rs       # 库
    ├── main.rs      # 主程序
    └── bin/
        └── cli.rs   # 额外的二进制

默认项目结构
├── Cargo.toml          # 必需
├── src/
│   ├── lib.rs          # 库入口（可选）
│   └── main.rs         # 程序入口（可选）
├── tests/              # 集成测试（自动识别）
├── examples/           # 示例程序（自动识别）
└── benches/            # 性能测试（自动识别）

# 创建项目后立即可以运行
cargo new hello_world
cd hello_world
cargo run
# 输出：Hello, world!

# 加速编译
cargo build --release -j 8    # 并行编译

# 减小二进制大小
cargo build --release
strip target/release/my_app   # 移除符号信息

# 跨平台编译
rustup target add x86_64-pc-windows-gnu
cargo build --target x86_64-pc-windows-gnu