Rust 入门指南（crate 管理）

本文为「Rust 入门指南」系列的第二部分。 这篇文章将重点介绍 cargo cli 工具和 Rust 的包管理系统，包括：

本文主要介绍 cargo 命令行和 Rust 的包管理系统，包括

• 搜索 crates
• 在项目中使用 crates
• 配置 crate
• 安装 / 使用 cargo-watch

Rust 的基础知识可以参考上一篇内容 Rust — 入门指南（rustup, cargo)

可以使用 https://geekcode.cloud 云开发环境一键创建 rust 环境快速开始后面的内容。

接下来的内容默认你已经读过上一篇的内容，并在 https://geekcode.cloud 体验了 rustc 和 rustup。

Crates

crates 就是Rust 包。 生成的 crates 注册在 crates.io 仓库上，我们可以在 crates.io 找到全部的 crates。

使用 cargo 命令搜索 crate。 例如，要搜索与 sql 相关的 crates :

$ cargo search sql

search 命令的结果显示与相关的 crate 名称和版本号：

使用 Crates

把需要的 crates 添加到 Cargo.toml 文件中。

使用$ cargo new {project_name} 创建出的 Cargo.toml 内容：

[package]
name = "hello_world"
version = "0.1.0"
edition = "2022"# See more keys and their definitions athttps://doc.rust-lang.org/cargo/reference/manifest.html[dependencies]

编辑 Cargo.toml 文件，添加上面搜索到的 sql create:

[package]
name = "hello_world"
version = "0.1.0"
edition = "2018"# See more keys and their definitions athttps://doc.rust-lang.org/cargo/reference/manifest.html[dependencies]
sql = "0.4.3"           <-- Add dependency here

注意，Cargo 依赖项与 SemVer 语法完全兼容，允许按需选择性更新。

Crates、Git 和 Feature toggles

Cargo 有很强大的功能获得 crates 。可以使用不同的方式指定 crate 。

标准方式：

[dependencies]
bracket-lib = “~0.8.1”

指定 Git 仓库：

[dependencies]
bracket-lib ={ git = "https://github.com/thebracket/bracket-lib" }

使用 feature toggles ，在下面的示例中，使用 bracket-lib ，但禁用默认渲染引擎并使用 vulkan 引擎 -

[dependencies]
bracket-lib = {
  git = "https://github.com/thebracket/bracket-lib",
  default-features = false,
  features = [ "amethyst_engine_vulkan" ]
}

源（Source）和二进制 Crates

C# 或 NPM 工程师，会注意到在添加 crate 后运行$ cargo build 时控制台输出：

Compiling sql v0.4.3
Compiling hello_world v0.1.0 (/Users/gian/hello_world)
    Finished dev [unoptimized + debuginfo] target(s) in 0.99s

大多数 Rust crate 都是基于源码的，添加到本地项目时，cargo 会自动获取源代码，然后在平台编译 crate。

如果指定不同的 target 平台，cargo 会重新编译所有 crate。

Cargo 支持安装 binary crates，特定于 crates 是可执行文件。 所以 cargo 获取、编译然后安装生成的可执行文件。

要安装二进制 crate，您可以直接使用 cargo:

$ cargo install {crate_name}

注意：使用 cargo install仅支持二进制 crate。 不能使用此命令来安装/添加常规 crate。

请看下面 cargo-watch 的示例。

Cargo-watch

对于大多数 crate，可以将它们直接添加到 Cargo.toml。 首先使用 cargo search 命令查找最新版本，或直接访问 crates.io，但不能使用 cargo install。

但是，如果安装的 crate 是二进制 crate，那么只能使用 cargo install 即可获取、编译和安装 crate 以供您使用。

注意： 与其他 crate 不同，安装二进制 crate 只需执行一次（除非需要更新二进制 crate 的版本）。

Updating crates.io index
Ignored package `cargo-watch v7.8.1` is already installed, use --force to override

cargo-watch 用于监控项目中的文件变化并运行命令。

安装 cargo-watch ：

$ cargo install cargo-watch

安装完成后，可以立即能够访问 cargo-watch 工具：

$ cargo-watch -x build

此命令将启动一个进程来监视项目中文件的更改，在这种情况下，当检测到更改时会自动运行cargo build。

您可以像这样将多个命令链接在一起 -

$ cargo-watch -x fmt -x test

如果您已安装了 Rust linter，但它会触发 linter，然后运行任何每次文件更改时测试！

您可以使用 cargo-watch 做更多事情，因此请查看 cargo-watch crate 文档。

总结

Rust crates 与大多数其他包装系统没有特别的不同，但如上所述，需要注意的事情很少。

cargo-watch crate 是二进制 crate 的例子，也是一个非常方便的实用程序，当您在 VSCode 中进行开发并希望对代码更改等进行即时反馈时。

还有很多有用的 crates 在crates.io 上。

keep rusty！

---

加入 GeekCode Community 参与定义 Cloud Based IDE

---

点击【阅读原文】访问 GeekCode