Cargo是Rust语言的包管理器和构建工具，它极大地简化了Rust项目的依赖管理、构建过程和发布流程。作为Rust生态系统的核心工具，熟练掌握Cargo的各种命令对于高效开发Rust项目至关重要。本文将全面介绍Cargo的所有命令及其用途。
基础构建与检查命令
cargo build
编译当前包及其所有依赖项。这是最常用的命令之一，默认会生成调试版本的可执行文件或库。
cargo build
cargo check
快速检查代码是否能编译通过，但不生成可执行文件。这个命令比完整构建快得多，适合在开发过程中频繁使用。
cargo check
cargo rustc
编译当前包，并可以传递额外的选项给rustc编译器。这个命令适合需要精细控制编译过程的高级用户。
cargo rustc -- -C opt-level=3
测试与基准测试
cargo test
运行项目的单元测试和集成测试。这是保证代码质量的关键命令。
cargo test
cargo bench
运行项目的基准测试。基准测试用于测量代码性能，需要单独编写。
cargo bench
文档相关命令
cargo doc
为当前包及其依赖项生成文档。生成的文档会放在target/doc目录下。
cargo doc --open # 生成并打开文档
cargo rustdoc
构建包的文档，可以使用自定义标志。这个命令提供了对文档生成过程的更多控制。
cargo rustdoc -- --no-defaults --passes "collapse-docs"
依赖管理
cargo fetch
从网络下载包的所有依赖项，但不编译它们。这在需要离线工作时很有用。
cargo fetch
cargo update
更新依赖项到符合Cargo.toml中指定约束的最新版本，并更新Cargo.lock文件。
cargo update
cargo tree
以树状结构显示依赖关系图。这对于理解复杂的依赖关系非常有帮助。
cargo tree
cargo vendor
将所有依赖项下载到本地vendor目录中。这在需要完全离线构建或确保构建可重复时很有用。
cargo vendor
项目创建与管理
cargo new
创建一个新的Cargo包。这是开始一个新项目的标准方式。
cargo new my_project
cargo init
在现有目录中初始化一个新的Cargo包。如果你已经有一个目录想转为Rust项目，可以使用这个命令。
mkdir my_project && cd my_project
cargo init
cargo locate-project
以JSON格式打印Cargo.toml文件的位置。这在脚本或工具中很有用。
cargo locate-project
cargo metadata
以机器可读的格式输出当前包的元数据。这个命令常用于工具集成。
cargo metadata --format-version=1
cargo pkgid
打印完整的包规格说明。这可以用于唯一标识一个包。
cargo pkgid
cargo verify-project
验证Cargo.toml清单的正确性。返回0表示清单有效。
cargo verify-project
代码质量与维护
cargo fix
自动修复rustc报告的lint警告。这是Rust提供的一个强大工具，可以自动修复许多常见问题。
cargo fix
cargo generate-lockfile
生成Cargo.lock文件。通常Cargo会在需要时自动生成，但有时需要手动触发。
cargo generate-lockfile
包发布与注册表操作
cargo login
将API令牌保存到本地，用于发布包到crates.io。
cargo login your-api-token
cargo publish
将包上传到注册表（通常是crates.io）。在发布前需要先登录。
cargo publish
cargo package
将本地包打包成可分发的tarball格式。这是发布过程的一部分。
cargo package
cargo yank
从索引中移除已发布的包版本。这不会删除已发布的代码，但会阻止新项目依赖该版本。
cargo yank --vers 1.0.0 my_package
cargo owner
管理crates.io上包的拥有者。可以添加、移除或列出包的拥有者。
cargo owner --add github_username my_package
cargo search
在crates.io中搜索包。这对于查找可用的库很有帮助。
cargo search regex
二进制安装与管理
cargo install
构建并安装一个Rust二进制包。这是安装Rust工具和应用的常用方式。
cargo install ripgrep
cargo uninstall
移除通过cargo install安装的Rust二进制文件。
cargo uninstall ripgrep
帮助与版本信息
cargo help
获取Cargo命令的帮助信息。可以查看特定子命令的详细用法。
cargo help build
cargo version
显示Cargo的版本信息。
cargo version
总结
Cargo作为Rust的包管理器和构建系统，提供了一套完整的工具链来管理Rust项目的整个生命周期。从项目创建、依赖管理、代码构建、测试到发布，Cargo都能提供强大而便捷的支持。掌握这些命令将大大提高你的Rust开发效率。
随着Rust生态系统的不断发展，Cargo也在持续进化，可能会添加新的命令或功能。建议定期查看官方文档以了解最新变化。通过熟练使用这些Cargo命令，你将能够更加自信和高效地构建Rust项目。