Rust 笔记： Rust 生态工具简要说明

long_run
1,508 阅读7分钟

前言

Rust是一种系统编程语言，注重内存安全、并发性和性能。其核心组件包括rustup、rustc和cargo，共同支持高效、安全的Rust开发。

rustup：Rust 工具链管理器

rustup 是 Rust 生态系统中用于管理 Rust 工具链的命令行工具。它允许你安装、更新和切换不同版本的 Rust 编译器和工具链，并且能够管理不同的组件，比如 cargo、rustfmt、clippy 等。下面是 rustup 的详细使用说明。

安装 Rustup

你可以通过以下命令安装 rustup：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装完成后，确保将 ~/.cargo/bin 添加到你的 PATH 环境变量中，以便能够在命令行中使用 rustup 和其他 Rust 工具。

基本用法

安装和更新工具链

  • 安装最新稳定版：

    rustup install stable

  • 安装特定版本：

    rustup install 1.56.0

  • 更新现有工具链：

    rustup update

rustup update 是用于更新 Rust 工具链的命令，而不是用于更新 rustup 本身。具体来说，它会更新你当前安装的 Rust 工具链版本，比如稳定版（stable）、测试版（beta）、或夜间版（nightly）等到最新的可用版本。

如果你需要更新 rustup 本身，可以使用以下命令：

rustup self update

这个命令会更新 rustup 工具到最新版本。通常，rustup 会自动检查自身的更新，并在执行其他命令时提示用户更新。

切换工具链

  • 查看已安装工具链：

    rustup toolchain list

  • 切换到特定工具链：

    rustup default stable

    或者切换到 nightly 版本：

    rustup default nightly

管理组件

  • 查看可用组件：

    rustup component list

  • 添加组件：

    rustup component add rustfmt

  • 移除组件：

    rustup component remove rustfmt

常用组件

以下是一些常用的 Rust 组件：

  1. rustc：Rust 编译器，这是默认安装的核心组件。
  2. cargo：Rust 的包管理器和构建工具，也是默认安装的。
  3. rustfmt：Rust 代码格式化工具，用于自动格式化 Rust 代码，使其符合官方风格指南。
  4. clippy：Rust 的代码分析工具，提供额外的 lint 检查，用于帮助开发者发现潜在的错误和改进代码质量。
  5. rust-docs：Rust 标准库文档，可以离线查看标准库的文档。
  6. rls（Rust Language Server）：提供 IDE 支持的工具，帮助在编辑器中实现代码补全、错误提示等功能（逐渐被 rust-analyzer 取代）。
  7. rust-analyzer：一个更现代的 Rust 语言服务器，提供更快速和智能的代码分析和编辑器支持。
  8. llvm-tools-preview：包含用于编译和分析的 LLVM 工具。
  9. miri：Rust 解释器，用于检测未定义行为。

本地和全局配置

  • 为当前项目指定工具链：

    在项目目录中运行：

    rustup override set nightly

    这会在该目录下创建一个 rust-toolchain 文件，指定该项目使用 nightly 版本。

  • 移除项目的工具链覆盖：

    rustup override unset

工具链的代理

rustup 会自动为 rustc、cargo 等命令创建代理，这意味着你可以在命令行直接使用这些命令，而不必手动管理它们的版本。

高级用法

交叉编译

rustup 支持交叉编译，通过安装目标架构来实现：

  • 查看可用目标：

    rustup target list

  • 添加目标：

    rustup target add wasm32-unknown-unknown

  • 移除目标：

    rustup target remove wasm32-unknown-unknown

自定义工具链

你可以下载和使用自定义的 Rust 工具链。例如，使用来自 GitHub 的自定义工具链：

rustup toolchain link my-toolchain /path/to/custom/toolchain

常用命令总结

  • rustup show：查看当前工具链和组件状态。
  • rustup which rustc：查看 rustc 的实际路径。
  • rustup self update：更新 rustup 自身。

总结

rustup 是 Rust 开发环境中不可或缺的工具，提供了便捷的工具链管理功能。通过 rustup，你可以轻松管理 Rust 的安装、更新、版本切换以及组件的添加和移除，适应不同的开发需求。无论是开发稳定的生产代码还是尝试最新的 Rust 特性，rustup 都能为你提供良好的支持。

cargo：Rust 的包管理器和构建工具

Cargo 是 Rust 的包管理器和构建工具，负责管理项目的依赖、构建、测试和发布。它是 Rust 开发中的核心工具之一，极大地简化了项目管理。以下是 Cargo 的使用说明和一些常用命令。

安装 Cargo

通常，Cargo 会随着 Rust 工具链一起安装。如果你已经安装了 Rust，Cargo 应该已经可用。

创建新项目

  • 创建可执行项目：

    cargo new my_project

    这将创建一个名为 my_project 的目录，其中包含一个基本的 Rust 项目结构。

  • 创建库项目：

    cargo new my_library --lib

    这将创建一个用于开发 Rust 库的项目。

构建项目

  • 构建项目：

    在项目目录中运行：

    cargo build

    这会在 target/debug 目录中生成可执行文件或库。

  • 构建发布版本：

    cargo build --release

    这会进行优化编译，并将输出放在 target/release 目录中。

运行项目

  • 运行项目：

    cargo run

    这会自动构建并运行项目。

测试项目

  • 运行测试：

    cargo test

    这会执行项目中的所有测试函数。

管理依赖

  • 添加依赖：

    在 Cargo.toml 文件中手动添加依赖项，例如：

    [dependencies]
serde = "1.0"

    然后运行：

    cargo build

    或者使用命令行直接添加：

    cargo add serde

  • 更新依赖：

    cargo update

    这会更新 Cargo.lock 文件中所有依赖的版本到最新的兼容版本。

发布项目

  • 发布到 crates.io：

    首先确保你已经注册并登录到 crates.io，然后运行：

    cargo publish

    这会将你的包发布到 crates.io。

其他有用的命令

  • 检查代码（不生成可执行文件） ：

    cargo check

    这可以快速检查代码的正确性。

  • 查看项目文档：

    cargo doc --open

    这会生成项目的文档并在浏览器中打开。

  • 清理构建目录：

    cargo clean

    这会删除 target 目录，从而清理构建输出。

总结

Cargo 是 Rust 生态系统中不可或缺的工具，简化了项目的创建、构建、测试和发布流程。通过 Cargo，开发者可以轻松管理项目的依赖，确保项目在不同环境中的一致性和可移植性。无论是小型项目还是大型应用，Cargo 都能提供强大的支持。

rustc：Rust 编译器

rustc 是 Rust 的编译器，用于将 Rust 源代码编译成可执行文件或库。虽然在日常开发中我们通常使用 Cargo 来管理项目和编译代码，但了解 rustc 的基本用法对于学习 Rust 的底层编译过程和处理简单的 Rust 文件还是很有帮助的。以下是 rustc 的一些基本使用说明和常用选项。

基本用法

假设你有一个简单的 Rust 文件 main.rs，可以使用 rustc 编译这个文件：

rustc main.rs

这会生成一个可执行文件，通常在 Unix 系统上命名为 main，在 Windows 系统上命名为 main.exe。

常用选项

  • 输出文件名：

    使用 -o 选项指定输出文件的名称：

    rustc main.rs -o my_program

    这会将输出文件命名为 my_program 或 my_program.exe。

  • 优化：

    使用 -O 选项进行优化编译，类似于 Cargo 中的 --release：

    rustc -O main.rs

  • 调试信息：

    使用 -g 选项生成调试信息，以便在调试器中使用：

    rustc -g main.rs

  • 编译为库：

    使用 --crate-type 选项编译为不同类型的库：

    rustc lib.rs --crate-type=lib

    这会生成一个 .rlib 文件。

  • 显示编译时的所有警告：

    使用 -Wall 可以启用所有警告（不过在 Rust 中，默认情况下大多数警告已经启用）：

    rustc -Wall main.rs

  • 链接库：

    使用 -L 选项指定额外的库搜索路径：

    rustc main.rs -L path/to/library

  • 自定义编译目标：

    使用 --target 选项指定编译目标：

    rustc main.rs --target=x86_64-unknown-linux-gnu

交叉编译

如果需要为不同的架构或操作系统编译代码，可以使用 --target 选项指定目标平台。例如：

rustc main.rs --target=armv7-unknown-linux-gnueabihf

需要注意的是，交叉编译通常需要安装相应的目标工具链，可以通过 rustup 进行安装：

rustup target add armv7-unknown-linux-gnueabihf

总结

rustc 是一个功能强大的编译器，适用于编译单个 Rust 文件或在需要精细控制编译过程时使用。尽管 Cargo 在大多数项目中是更常用的工具，因为它简化了依赖管理和构建过程，但了解 rustc 的用法对于深入理解 Rust 编译过程和处理特定需求仍然非常有价值。

avatar
文章
阅读
粉丝