cargo

Rust 项目与依赖管理工具

补充说明

cargo 是 Rust 的标准构建系统和包管理器，负责创建项目、解析依赖、编译、测试和发布。它调用 rustc，但补齐了依赖、特性和工作区管理。

常用示例

cargo new app
cargo init
cargo build
cargo build --release
cargo run -- arg1
cargo test
cargo test -- --nocapture
cargo check
cargo clippy --all-targets --all-features
cargo fmt --check
cargo add serde --features derive
cargo update
cargo tree
cargo doc --open
cargo install ripgrep
cargo clean

易错点与排错

• debug 和 release 的优化、断言和 panic 行为不同；性能问题先确认构建配置。
• 二进制项目应提交 Cargo.lock，库项目通常不提交；团队要统一。
• 特性（features）会改变编译结果；CI 至少要测默认特性和关键组合。
• cargo check 不生成可执行文件，但比 build 快，适合开发时反复验证。
• cargo install 装到用户目录，和项目的依赖无关；版本要显式指定。
• 工作区里 target/ 共享；磁盘占用大时先看 cargo clean 的影响范围。
• 离线构建要提前 cargo fetch；--offline 不会自动补依赖。
• rust-toolchain.toml 会固定工具链；换目录后行为可能不同。

相关命令

• rustc — 编译器
• rustup — 工具链管理
• clippy — 静态检查