跳到主要内容

cargo

cargo 是 Rust 的包管理工具,它允许您管理 Rust 项目的依赖项、构建和测试。

  • 构建代码,下载依赖的库、构建这些库。
提示
  • 安装rust的时候会自动安装cargo。
  • Rust开发者在创建新的项目时,cargo 会自动初始化一个Git存储库(如果系统中安装了Git),以便开发者可以立即开始使用版本控制。
  • 代码的包称作crate。

常用命令

当使用 Cargo 进行 Rust 项目管理时,以下是一些常用的 Cargo 命令及其详细解释:

  1. cargo new
    • 创建一个新的 Rust 项目。
    • 语法:cargo new <project_name>
    • 这个命令会创建一个新的目录,其中包含了一个 Rust 项目的基本结构,包括 Cargo.toml 文件和 src/main.rs 文件。
提示
  • cargo new my_project 的时候会自动生成git版本控制系统。
  • 可以通过 --vcs none 取消版本控制。默认值是git。
  1. cargo build

    • 构建 Rust 项目,生成可执行文件或库文件。

    • 语法:cargo build

    • 默认情况下,它将生成可执行文件,并将其放在项目的 target/debug 目录下。

    • --release

      • 生成优化后的 release 版本可执行文件。
      • 语法:cargo build --release
      • 该命令会在 target/release 目录下生成优化后的可执行文件。这个版本的可执行文件通常比调试版本更快,但编译时间会更长。
  2. cargo run

    • 编译构建+执行结果。
    • 语法:cargo run
    • 这个命令会先执行 cargo build,然后运行生成的可执行文件。
    • 如果之前编译成功过的话,并且源代码没有改变的,那么就会直接运行二进制文件。
  3. cargo test

    • 运行 Rust 项目中的测试。
    • 语法:cargo test
    • Cargo 会自动查找项目中的测试函数并运行它们。测试函数可以在 src 目录中的任何文件中以 #[cfg(test)] 属性标记。
  4. cargo doc

    • 生成 Rust 项目的文档。
    • 语法:cargo doc
    • 这个命令会生成项目的文档并保存到 target/doc 目录中。您可以在本地浏览器中打开生成的 HTML 文档。
  5. cargo clean

    • 清理 Rust 项目的构建产物。
    • 语法:cargo clean
    • 这个命令会删除 target 目录,其中包含了编译生成的所有文件,包括可执行文件、库文件以及文档。
  6. cargo check

    • 检查代码,确保能编译通过,但不生成可执行文件。
    • 语法:cargo check
    • 这个命令会检查代码的语法和类型错误,但不会进行代码生成或优化,因此比 cargo build 更快。
    • 编写代码的时候可以连续反复的使用检查代码提高效率。
  7. cargo update

    • 更新项目依赖库的 锁定版本。通过 cargo update,你可以让 Cargo 检查是否有新的可用版本,并更新 Cargo.lock 中的记录。
    • 更新特定依赖 cargo update -p serde