附录 B: 常用 Cargo 命令速查

Cargo 是 Rust 的官方构建系统和包管理器，集项目管理、依赖解析、编译、测试、文档生成等功能于一体。以下列出开发中最常用的命令及其典型用法。

项目创建与初始化

cargo new my_project          # 创建新的二进制项目（含 main.rs）
cargo new --lib my_lib        # 创建新的库项目（含 lib.rs）
cargo init                    # 在当前目录初始化新项目

构建与运行

cargo build                   # 编译项目（debug 模式，默认输出到 target/debug/）
cargo build --release         # 编译发布版本（启用优化，输出到 target/release/）
cargo run                     # 编译并运行二进制项目
cargo run --release           # 以 release 模式运行
cargo run --bin other_bin     # 运行指定的二进制目标（适用于多 bin 项目）

测试

cargo test                    # 运行所有测试（单元测试、集成测试、文档测试）
cargo test -- --nocapture     # 显示 println! 输出
cargo test some_test_name     # 只运行名称匹配的测试
cargo test --doc              # 仅运行文档测试（doctest）

依赖管理

cargo add serde               # 添加依赖（需安装 cargo-edit）
cargo add --dev tokio         # 添加开发依赖
cargo update                  # 更新依赖到兼容的最新版本（遵循 Cargo.lock）
cargo tree                    # 查看依赖树（需 Rust 1.44+ 或安装 cargo-tree）

注：cargo add 等便捷命令需安装 cargo-edit：cargo install cargo-edit

文档与检查

cargo doc                     # 为本地项目及依赖生成文档（存于 target/doc/）
cargo doc --open              # 生成并自动在浏览器中打开文档
cargo check                   # 快速检查代码是否能编译（不生成二进制，速度更快）
cargo fmt                     # 格式化代码（需安装 rustfmt，通常随 Rust 工具链自带）
cargo clippy                  # 运行 Clippy 静态分析（需安装：rustup component add clippy）

发布与清理

cargo publish                 # 将 crate 发布到 crates.io（需先登录）
cargo login                   # 登录 crates.io 账户
cargo clean                   # 删除 target/ 目录，清理构建产物

其他实用命令

cargo install <crate>         # 安装二进制 crate 到本地（如 cargo-watch, flamegraph）
cargo uninstall <crate>       # 卸载已安装的二进制 crate
cargo metadata                # 以 JSON 格式输出项目元数据（供工具使用）
cargo fix                     # 自动应用编译器建议的修复（如迁移 lint）

环境变量常用配置

• CARGO_TARGET_DIR：指定构建输出目录；
• RUST_LOG：控制日志级别（配合 env_logger 或 tracing-subscriber）；
• RUST_BACKTRACE=1：在 panic 时显示完整调用栈。

小结

熟练掌握 Cargo 命令能极大提升开发效率。大多数日常操作（编译、测试、格式化、依赖添加）均可通过上述命令完成。建议将 cargo check、cargo fmt 和 cargo clippy 纳入编辑器保存钩子或 CI 流程，保持代码质量。更多细节可通过 cargo help <command> 查阅。