Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

使用 Rust 1.75.0 Toolset

Red Hat Developer Tools 1

安装和使用 Rust 1.75.0 Toolset

Jacob Valdez

Red Hat Developer Group Documentation Team

摘要

Rust Toolset 是 Red Hat Enterprise Linux (RHEL)操作系统的开发人员提供的红帽产品。使用本指南了解 Rust Toolset 的概述，了解如何调用和使用不同版本的 Rust 工具，并通过更深入的信息查找资源。

使开源包含更多
复制链接

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息。

第 1 章 Rust Toolset
复制链接

Rust Toolset 是 Red Hat Enterprise Linux (RHEL)的开发人员提供的红帽产品。它为 Rust 编程语言提供 Rust c 编译器、Rust 软件包管理器 Cargo、Rustfmt 格式化工具和所需的库。

对于 Red Hat Enterprise Linux 8，Rust Toolset 作为模块提供。Rust Toolset 作为 Red Hat Enterprise Linux 9 的软件包提供。

1.1. Rust Toolset 组件
复制链接

以下组件作为 Rust Toolset 的一部分提供：

Expand
Name版本描述

rust

1.75.0

LLVM 的 Rust 编译器前端。

cargo

1.75.0

Rust 的构建系统和依赖项管理器。

rustfmt

1.75.0

用于自动格式化 Rust 代码的工具。

1.2. Rust Toolset 兼容性
复制链接

Rust Toolset 在以下构架中为 Red Hat Enterprise Linux 8 和 Red Hat Enterprise Linux 9 提供：

  • AMD 和 Intel 64 位
  • 64-bit ARM
  • IBM Power Systems, Little Endian
  • 64-bit IBM Z

1.3. 安装 Rust Toolset
复制链接

完成以下步骤以安装 Rust Toolset，包括所有开发和调试工具以及依赖软件包。请注意，Rust Toolset 依赖于 LLVM Toolset。

先决条件

  • 已安装所有可用的 Red Hat Enterprise Linux 更新。

流程

在 Red Hat Enterprise Linux 8 中，运行以下命令安装 Rust-toolset 模块： 

# yum module install rust-toolset
Copy to Clipboard Toggle word wrap

在 Red Hat Enterprise Linux 9 中，运行以下命令安装 Rust-toolset 软件包： 

# dnf install rust-toolset
Copy to Clipboard Toggle word wrap

1.4. 安装 Rust 文档
复制链接

Rust 编程语言书 作为可安装的文档提供。

先决条件

流程

要安装 Rust-doc 软件包，请运行以下命令：

  • 在 Red Hat Enterprise Linux 8 中： 

    # yum install rust-doc
    Copy to Clipboard Toggle word wrap

    您可以在以下路径下找到 Rust 编程语言 书： /usr/share/doc/rust/html/index.html。
    您可以在以下路径中找到所有 Rust 代码软件包的 API 文档： /usr/share/doc/rust/html/std/index.html。

  • 在 Red Hat Enterprise Linux 9 中： 

    # dnf install rust-doc
    Copy to Clipboard Toggle word wrap

    您可以在以下路径下找到 Rust 编程语言 书： /usr/share/doc/rust/html/index.html。
    您可以在以下路径中找到所有 Rust 代码软件包的 API 文档： /usr/share/doc/rust/html/std/index.html。

1.5. 安装 Cargo 文档
复制链接

Cargo, Rust 的 Package Manager 书作为 Cargo 的可安装文档。

注意

在 Rust Toolset 1.66.1 中，cargo-doc 软件包包含在 Rust -doc 软件包中。

先决条件

流程

  • 要安装 cargo-doc 软件包，请运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      # yum install cargo-doc
      Copy to Clipboard Toggle word wrap

      您可以在以下路径下找到 Cargo, Rust 的 Package Manager 书： /usr/share/doc/cargo/html/index.html。

    • 在 Red Hat Enterprise Linux 9 中： 

      # dnf install cargo-doc
      Copy to Clipboard Toggle word wrap

      您可以在以下路径下找到 Cargo, Rust 的 Package Manager 书： /usr/share/doc/cargo/html/index.html。

第 2 章 Cargo 构建工具
复制链接

cargo 是 Rust 编译器 Rust c 的构建工具和 前端，以及软件包和依赖项管理器。它允许 Rust 项目声明具有特定版本要求的依赖关系，解析完整依赖项图、下载软件包和构建，以及测试整个项目。

Rust Toolset 带有 Cargo 1.75.0。

2.1. Cargo 目录结构和文件放置
复制链接

Cargo 构建工具使用设置惯例来定义在 Cargo 软件包中目录结构和文件放置。运行 cargo new 命令会为清单和项目文件生成软件包目录结构和模板。默认情况下，它还在软件包根目录中初始化新的 Git 存储库。

对于二进制程序，Cargo 会创建一个目录 project_name，其中包含一个名为 Cargo.toml 的文本文件，以及一个包含名为 main.rs 的文本文件的子目录 src。

2.2. 创建 Rust 项目
复制链接

根据 Cargo 约定，创建一个新的 Rust 项目。有关 Cargo 约定的更多信息，请参阅 Cargo 目录结构和文件放置。

流程

运行以下命令来创建 Rust 项目：

  • 在 Red Hat Enterprise Linux 8 中： 

    $ cargo new --bin <project_name>
    Copy to Clipboard Toggle word wrap
    • 将 <project_name > 替换为您的项目名称。

  • 在 Red Hat Enterprise Linux 9 中： 

    $ cargo new --bin <project_name>
    Copy to Clipboard Toggle word wrap
    • 将 <project_name > 替换为您的项目名称。
注意

要编辑项目代码，请编辑主可执行文件 main.rs，并将新源文件添加到 src 子目录。

其他资源

2.3. 创建 Rust 库项目
复制链接

完成以下步骤，使用 Cargo 构建工具创建 Rust 库项目。

流程

要创建 Rust 库项目，请运行以下命令：

  • 在 Red Hat Enterprise Linux 8 中： 

    $ cargo new --lib <project_name>
    Copy to Clipboard Toggle word wrap
    • 将 <project_name > 替换为 Rust 项目的名称。

  • 在 Red Hat Enterprise Linux 9 中： 

    $ cargo new --lib <project_name>
    Copy to Clipboard Toggle word wrap
    • 将 <project_name > 替换为 Rust 项目的名称。
注意

要编辑项目代码，请编辑 src 子目录中的源文件 lib.rs。

其他资源

2.4. 构建 Rust 项目
复制链接

使用 Cargo 构建工具构建 Rust 项目。cargo 解析项目的所有依赖项，下载缺少的依赖项，并使用 Rust c 编译器编译它。

默认情况下，项目以调试模式构建和编译。有关以发行模式编译项目的详情，请参考 以发行模式构建 Rust 项目。

先决条件

  • 现有的 Rust 项目。
    有关如何创建 Rust 项目的详情，请参考 创建 Rust 项目。

流程

  • 要构建由 Cargo 管理的 Rust 项目，请在项目目录中运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      $ cargo build
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      $ cargo build
      Copy to Clipboard Toggle word wrap
  • 要验证您的 Rust 程序是否可以在您不需要构建可执行文件时构建，请运行： 
$ cargo check
Copy to Clipboard Toggle word wrap

2.5. 以发行版本模式构建 Rust 项目
复制链接

使用 Cargo 构建工具以发行版本模式构建 Rust 项目。发行模式用于优化源代码，因此可以增加编译时间，同时确保编译的二进制文件可以更快地运行。使用此模式生成适合发布和生产的优化的工件。
cargo 解析项目的所有依赖项，下载缺少的依赖项，并使用 Rust c 编译器编译它。

有关以调试模式编译项目的详情，请参考 构建 Rust 项目。

先决条件

  • 现有的 Rust 项目。
    有关如何创建 Rust 项目的详情，请参考 创建 Rust 项目。

流程

  • 要以 release 模式构建项目，请运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      $ cargo build --release
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      $ cargo build --release
      Copy to Clipboard Toggle word wrap
  • 要在不需要构建可执行文件时验证您的 Rust 程序是否可以构建，请运行： 
$ cargo check
Copy to Clipboard Toggle word wrap

2.6. 运行 Rust 程序
复制链接

使用 Cargo 构建工具运行 Rust 项目。cargo 首先重建您的项目，然后运行生成的可执行文件。如果在开发过程中使用，cargo run 命令可以正确地解析输出路径，独立于构建模式。

先决条件

  • 构建的 Rust 项目。
    有关如何构建 Rust 项目的详情，请参考 构建 Rust 项目。

流程

要通过 Cargo 运行作为项目管理的 Rust 程序，请在项目目录中运行：

  • 在 Red Hat Enterprise Linux 8 中： 

    $ cargo run
    Copy to Clipboard Toggle word wrap

  • 在 Red Hat Enterprise Linux 9 中： 

    $ cargo run
    Copy to Clipboard Toggle word wrap
注意

如果您的程序还没有构建，Cargo 会在运行之前构建您的程序。

2.7. 测试 Rust 项目
复制链接

使用 Cargo 构建工具测试您的 Rust 程序。cargo 首先重新构建您的项目，然后运行项目中找到的测试。请注意，您只能测试免费、monomorphic 并且不使用任何参数的功能。函数返回类型必须是 （） 或 Result< （）, E>，其中 E: Error。

默认情况下，Rust 项目在 debug 模式中测试。有关在发行版本模式中测试您的项目的详情，请参考以 发行模式测试 Rust 项目。

先决条件

  • 构建的 Rust 项目。
    有关如何构建 Rust 项目的详情，请参考 构建 Rust 项目。

流程

  • 在功能前面添加 test 属性 #[test]。

  • 要为由 Cargo 管理的 Rust 项目运行测试，请在项目目录中运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      $ cargo test
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      $ cargo test
      Copy to Clipboard Toggle word wrap

2.8. 以发行版本模式测试 Rust 项目
复制链接

使用 Cargo 构建工具以发行版本模式测试您的 Rust 程序。发行模式用于优化源代码，因此可以增加编译时间，同时确保编译的二进制文件可以更快地运行。使用此模式生成适合发布和生产的优化的工件。
cargo 首先重新构建您的项目，然后运行项目中找到的测试。请注意，您只能测试免费、monomorphic 并且不使用任何参数的功能。函数返回类型必须是 （） 或 Result< （）, E>，其中 E: Error。

有关以调试模式测试项目的信息，请参阅 测试 Rust 项目。

先决条件

  • 构建的 Rust 项目。
    有关如何构建 Rust 项目的详情，请参考 构建 Rust 项目。

流程

  • 在功能前面添加 test 属性 #[test]。

  • 要为在发行模式的 Cargo 管理的 Rust 项目运行测试，请在项目目录中运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      $ cargo test --release
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      $ cargo test --release
      Copy to Clipboard Toggle word wrap

2.9. 配置 Rust 项目依赖项
复制链接

使用 Cargo 构建工具配置 Rust 项目的依赖项。要指定由 Cargo 管理的项目的依赖项，请编辑项目目录中的 Cargo.toml 文件并重新构建您的项目。cargo 下载 Rust 代码软件包及其依赖项，将其存储在本地，构建包括依赖项代码软件包在内的所有项目源代码，并运行生成的可执行文件。

先决条件

  • 构建的 Rust 项目。
    有关如何构建 Rust 项目的详情，请参考 构建 Rust 项目。

流程

  1. 在项目目录中，打开文件 Cargo.toml。

  2. 移到标记的 [dependencies] 部分。
    每个依赖项都以以下格式列在新行中： 

    crate_name = version
    Copy to Clipboard Toggle word wrap

    Rust 代码软件包称为 crates。

  3. 编辑依赖项。

  4. 运行以下命令重建项目：

    • 在 Red Hat Enterprise Linux 8 中： 

      $ cargo build
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      $ cargo build
      Copy to Clipboard Toggle word wrap

  5. 使用以下命令运行项目：

    • 在 Red Hat Enterprise Linux 8 中： 

      $ cargo run
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      $ cargo run
      Copy to Clipboard Toggle word wrap

2.10. 为 Rust 项目构建文档
复制链接

使用 Cargo 工具从标记为提取的源代码中的注释生成文档。请注意，仅针对公共功能、变量和成员提取文档注释。

先决条件

流程

  • 要标记提取的注释，请使用三个斜杠 ///，并将您的注释放在要记录的行首。
    cargo 支持您评论的 Markdown 语言。

  • 要使用 Cargo 构建项目文档，请在项目目录中运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      $ cargo doc --no-deps
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      $ cargo doc --no-deps
      Copy to Clipboard Toggle word wrap

生成的文档位于 .target/doc 目录中。

完成以下步骤以安装 WebAssembly 标准库。

先决条件

流程

  • 要安装 WebAssembly 标准库，请运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      # yum install rust-std-static-wasm32-unknown-unknown
      Copy to Clipboard Toggle word wrap

    • 在 Red Hat Enterprise Linux 9 中： 

      # dnf install rust-std-static-wasm32-unknown-unknown
      Copy to Clipboard Toggle word wrap

  • 要将 WebAssembly 与 Cargo 搭配使用，请运行：

    • 在 Red Hat Enterprise Linux 8 中： 

      # cargo <command> --target wasm32-unknown-unknown
      Copy to Clipboard Toggle word wrap

      将 &lt;command > 替换为您要运行的 Cargo 命令。

    • 在 Red Hat Enterprise Linux 9 中： 

      # cargo <command> --target wasm32-unknown-unknown
      Copy to Clipboard Toggle word wrap

      将 &lt;command > 替换为您要运行的 Cargo 命令。

2.12. 供应商 Rust 项目依赖项
复制链接

创建 Rust 项目依赖项的本地副本，以便离线重新发布并使用 Cargo 构建工具重复使用。此流程称为供应商项目依赖项。厂商的依赖项，包括用于在 Windows 操作系统上构建项目的 Rust 代码软件包位于 供应商 目录中。Cargo 可以使用供应商的依赖项，而无需连接到互联网。

先决条件

流程

要使用 Cargo 来厂商您的 Rust 项目，请在项目目录中运行：

  • 在 Red Hat Enterprise Linux 8 中： 

    $ cargo vendor
    Copy to Clipboard Toggle word wrap

  • 在 Red Hat Enterprise Linux 9 中： 

    $ cargo vendor
    Copy to Clipboard Toggle word wrap

第 3 章 Rustfmt 格式化工具
复制链接

使用 Rustfmt 格式工具，您可以自动格式化 Rust 程序的源代码。您可以将 rusftmt 用作独立工具，也可以使用 Cargo。

3.1. 安装 Rustfmt
复制链接

完成以下步骤以安装 Rustfmt 格式化 工具。

先决条件

流程

运行以下命令来安装 Rust fmt ：

  • 在 Red Hat Enterprise Linux 8 中： 

    # yum install rustfmt
    Copy to Clipboard Toggle word wrap

  • 在 Red Hat Enterprise Linux 9 中： 

    # dnf install rustfmt
    Copy to Clipboard Toggle word wrap

3.2. 使用 Rustfmt 作为独立工具
复制链接

使用 Rustfmt 作为独立工具来格式化 Rust 源文件及其所有依赖项。作为替代方案，在 Cargo 构建工具中使用 Rustfmt。如需更多信息，请参阅使用带有 Cargo 的 Rustfmt。

先决条件

  • 现有的 Rust 项目。
    有关如何创建 Rust 项目的详情，请参考 创建 Rust 项目。

流程

要使用 Rustfmt 作为独立 工具 格式化 Rust 源文件，请运行以下命令：

  • 在 Red Hat Enterprise Linux 8 中： 

    $ rustfmt <source-file>
    Copy to Clipboard Toggle word wrap
    • 将 <source_file > 替换为源文件的名称。
      另外，您可以将 &lt ;source_file&gt; 替换为标准输入。Rust fmt 随后在标准输出中提供其输出。

  • 在 Red Hat Enterprise Linux 9 中： 

    $ rustfmt <source-file>
    Copy to Clipboard Toggle word wrap
    • 将 <source_file > 替换为源文件的名称。
      另外，您可以将 &lt ;source_file&gt; 替换为标准输入。Rust fmt 随后在标准输出中提供其输出。
注意

默认情况下，Rust fmt 修改受影响的文件，而不显示详情或创建备份。要显示详情并创建备份，请使用 --write-mode 值运行 Rustfmt。

3.3. 使用带有 Cargo 构建工具的 Rustfmt
复制链接

使用带有 Cargo 的 Rustfmt 工具格式化 Rust 源文件及其所有依赖项。
作为替代方案，使用 Rust fmt 作为独立工具。如需更多信息，请参阅使用 Rustfmt 作为独立工具。

先决条件

  • 现有的 Rust 项目。
    有关如何创建 Rust 项目的详情，请参考 创建 Rust 项目。

流程

要格式化 Cargo 代码软件包中的所有源文件，请运行以下命令：

  • 在 Red Hat Enterprise Linux 8 中： 

    $ cargo fmt
    Copy to Clipboard Toggle word wrap

  • 在 Red Hat Enterprise Linux 9 中： 

    $ cargo fmt
    Copy to Clipboard Toggle word wrap
注意

要更改 Rust fmt 格式选项，请在 项目目录中创建配置文件 Rustfmt.toml，并将您的配置添加到该文件中。

第 4 章 RHEL 8 上带有 Rust Toolset 的容器镜像
复制链接

在 RHEL 8 中，您可以使用 Containerfiles 在 Red Hat Universal Base Images (UBI)容器之上构建自己的 Rust Toolset 容器镜像。

4.1. 在 RHEL 8 中创建 Rust Toolset 的容器镜像
复制链接

在 RHEL 8 中，Rust Toolset 软件包是 Red Hat Universal Base Images (UBI)存储库的一部分。要将容器大小保持小，请只安装单个软件包，而不是整个 Rust Toolset。

先决条件

  • 现有的 Containerfile。
    有关创建 Containerfiles 的更多信息，请参阅 Dockerfile 参考 页面。

流程

  • 访问 Red Hat Container Catalog。
  • 选择 UBI。
  • 点 Get this image 并按照说明进行操作。
  • 要创建包含 Rust Toolset 的容器，请在 Containerfile 中添加以下行： 
FROM registry.access.redhat.com/ubi8/ubi:latest

RUN yum install -y rust-toolset
Copy to Clipboard Toggle word wrap
  • 要创建仅包含单个软件包的容器镜像，请在 Containerfile 中添加以下行： 
RUN yum install <package-name>
Copy to Clipboard Toggle word wrap
  • 将 < package_name > 替换为您要安装的软件包的名称。

第 5 章 Rust 1.75.0 Toolset 中的更改
复制链接

Rust Toolset 已从 RHEL 8 和 RHEL 9 上的 1.71.1 更新至 1.75.0。

主要变更包括：

  • 持续评估时间现在没有限制
  • cleaner panic 信息
  • cargo registry 身份验证
  • 在特征中 async fn 和 opaque 返回类型

法律通告
复制链接

Copyright © 2024 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat