作者：李俊才 （jcLee95）：https://blog.csdn.net/qq_28550263?spm=1001.2101.3001.5343
邮箱 ：291148484@163.com
本文地址：https://blog.csdn.net/qq_28550263/article/details/130761337

【介绍】：本文记叙搭建 Rust 语言安装开发环境，及其相关工具知识的准备。

1. 搭建 rust 开发环境

1.1 安装 Rust

1.1.1 Linux 上安装 Rust

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

1.1.2 Windows 上安装 Rust

The Cargo home directory is located at:

  C:\Users\a2911\.cargo

This can be modified with the CARGO_HOME environment variable.

The cargo, rustc, rustup and other commands will be added to
Cargo's bin directory, located at:

  C:\Users\a2911\.cargo\bin

This path will then be added to your PATH environment variable by
modifying the HKEY_CURRENT_USER/Environment/PATH registry key.

You can uninstall at any time with rustup self uninstall and
these changes will be reverted.

Current installation options:


   default host triple: x86_64-pc-windows-msvc
     default toolchain: stable (default)
               profile: default
  modify PATH variable: yes

1) Proceed with installation (default)
2) Customize installation
3) Cancel installation
>

>1

info: profile set to 'default'
info: default host triple is x86_64-pc-windows-msvc
info: syncing channel updates for 'stable-x86_64-pc-windows-msvc'
info: latest update on 2023-04-20, rust version 1.69.0 (84c898d65 2023-04-16)
info: downloading component 'cargo'
info: downloading component 'clippy'
info: downloading component 'rust-docs'
 13.4 MiB /  13.4 MiB (100 %)   7.4 MiB/s in  2s ETA:  0s
info: downloading component 'rust-std'
 25.1 MiB /  25.1 MiB (100 %)  11.2 MiB/s in  2s ETA:  0s
info: downloading component 'rustc'
 58.9 MiB /  58.9 MiB (100 %)  10.2 MiB/s in  5s ETA:  0s
info: downloading component 'rustfmt'
info: installing component 'cargo'
info: installing component 'clippy'
info: installing component 'rust-docs'
 13.4 MiB /  13.4 MiB (100 %)   1.6 MiB/s in  6s ETA:  0s
info: installing component 'rust-std'
 25.1 MiB /  25.1 MiB (100 %)  13.2 MiB/s in  1s ETA:  0s
info: installing component 'rustc'
 58.9 MiB /  58.9 MiB (100 %)  14.5 MiB/s in  4s ETA:  0s
info: installing component 'rustfmt'
info: default toolchain set to 'stable-x86_64-pc-windows-msvc'

  stable-x86_64-pc-windows-msvc installed - rustc 1.69.0 (84c898d65 2023-04-16)


Rust is installed now. Great!

To get started you may need to restart your current shell.
This would reload its PATH environment variable to include
Cargo's bin directory (%USERPROFILE%\.cargo\bin).

Press the Enter key to continue.

1.2 安装 Rust 的 VSCode 插件

1.2.1 rust-analyzer 插件

1.3 关于 Rust 的更新

2. Rust安装程序和版本管理工具： rustup

2.1 rustup 的安装位置

2.2 rustup 的用法

2.2.1 rustup 命令行语法格式

rustup [OPTIONS] [+toolchain] <SUBCOMMAND>

2.2.2 rustup 命令参数与选项解析

3. Rust包管理器：cargo

3.1 cargo 是什么

3.2.1 cargo 命令行语法格式

cargo [+toolchain] [OPTIONS] [COMMAND]

3.2.2 cargo 命令参数与选项解析

1. 选项（Options）：

cargo 命令具有以下选项：

• -V, --version 打印版本信息并退出
  • --list 列出已安装的命令
  • --explain <CODE> 运行 rustc --explain CODE
• -v, --verbose… 使用详细输出(-vv very verbose/build.rs输出)
• -q, --quiet 不要打cargo 物日志信息
  --color <WHEN> 着色: auto, always, never
• -C <DIRECTORY> 在做任何事情之前切换到目录 (nightly-only)
  • --frozen 要求 Cargo.lock 和 cache 是最新的
  • --locked 要求 Cargo.lock 是最新的
  • --offline 不访问网络运行
  • --config <KEY=VALUE> 覆盖配置值
• -Z <FLAG> Cargo的不稳定(nightly-only)标志，详情见cargo -Z help
• -h, --help 打印帮助信息

2. 命令（Commands）：

• build, b 编译当前包
• check, c 分析当前包并报告错误，但不构建目标文件
• clean 删除 target 目录
• doc, d 构建此包及其依赖项的文档
• new 创建新的 cargo 包
• init 在现有目录中创建新的 cargo 包
• add 向清单文件添加依赖项
• remove 从清单文件中移除依赖项
• run, r 运行本地包的二进制或示例
• test, t 运行测试
• bench 运行 benchmarks
• update 更新 Cargo.lock 中列出的依赖项
• search 搜索 crates 注册表
• publish 打包并将此包上传到注册表
• install 安装一个Rust二进制文件。默认位置是 $HOME/.cargo/bin
• uninstall 卸载Rust二进制文件

注：

• 一些常见的cargo命令有(参见所有带 --list的命令)

4. rust 项目构建与 rustc 工具（rust 语言的编译器）

4.1 cargo build 命令

cargo build [options]

Package选择 选项

默认情况下，当没有给出包选择选项时，所选择的包取决于所选择的清单文件(如果没有给出 --manifest-path，则基于当前工作目录)。如果清单是工作区的根，则选择工作区的默认成员，否则只选择清单定义的包。
可以使用根清单中的workspace.default-members键显式设置工作区的默认成员。如果没有设置，虚拟工作空间将包括所有的工作空间成员(相当于传入选项 --workspace)，而非虚拟工作空间将只包括root crate本身。

• -p spec…, --package spec… 仅构建指定的包。该标志可以多次指定，并支持常见的Unix全局模式，如*、?和[]。然而，为了避免您的shell在Cargo处理glob模式之前意外扩展它们，您必须在每个模式周围使用单引号或双引号。

• --workspace 构建工作区中的所有成员。

• --all 不推荐使用 --workspace。

• --exclude SPEC… 排除指定的包。必须与 --workspace 标志一起使用。该标志可以多次指定，并支持常见的Unix全局模式，如*、?和[]。然而，为了避免您的shell在Cargo处理glob模式之前意外扩展它们，您必须在每个模式周围使用单引号或双引号。

Target选择 选项

当没有给出目标选择选项时，cargo build将构建所选包的所有二进制和库目标。如果二进制文件缺少必需的特性，它们将被跳过。如果选择了要构建的集成测试或基准，那么二进制目标会自动构建。这允许集成测试执行二进制代码来测试它的行为。构建集成测试时会设置 CARGO_BIN_EXE_<name> 环境变量 <https://doc.rust-lang.org/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-crates> 以便它可以使用env宏 <https://doc.rust-lang.org/std/macro.env.html> 来定位可执行文件。传递目标选择标志将只构建指定的目标。注意 --bin、 --example、 --test 和 --bench 标志也支持常见的Unix全局模式，如*、? 和 []。然而，为了避免 shell 在 Cargo 处理 glob模式 之前意外地扩展它们，您必须在每个 glob模式 周围使用单引号或双引号。

• --lib 构建包的库。

• --bin name… 构建指定的二进制文件。该标志可以多次指定，并支持常见的Unix glob模式。

• --bins 构建所有二进制目标。

• --example name… 构建指定的示例。该标志可以多次指定，并支持常见的Unix glob模式。

• --examples 构建所有示例目标。

• --test name… 生成指定的集成测试。该标志可以多次指定，并支持常见的Unix glob模式。

• --tests 在测试模式下构建所有设置了 test = true清单标志的目标。默认情况下，这包括作为单元测试和集成测试构建的库和二进制文件。请注意，这也将构建任何所需的依赖项，因此lib目标可以构建两次(一次作为单元测试，一次作为二进制文件、集成测试等的依赖项。).可以通过在目标的清单设置中设置测试标志来启用或禁用目标。

• --bench name… 构建指定的benchmark(基准)。该标志可以多次指定，并支持常见的Unix glob模式。

• --benches 在基准模式下构建所有设置了 bench = true 清单标志的目标。默认情况下，这包括作为基准构建的库和二进制文件，以及基准目标。请注意，这也将构建任何所需的依赖项，因此lib目标可能会构建两次(一次作为基准，一次作为二进制文件、基准等的依赖项。).可以通过在目标的清单设置中设置bench标志来启用或禁用目标。

• --all-targets 构建所有目标。这相当于指定 --lib、--bins、--tests、--benches、--examples。

Feature选择 选项

功能标志( Feature Flag)允许您控制启用哪些功能。如果没有给定功能选项，则为每个选定的软件包激活默认功能。
请参见功能文档 https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options 了解更多详情。

• -F features, --features features 要激活的以空格或逗号分隔的功能列表。工作空间成员的功能可以用 package-name/feature-name 语法来启用。可以多次指定该标志，从而启用所有指定的功能。

• --all-features 激活所有选定软件包的所有可用功能。

• --no-default-features 不要激活所选软件包的默认功能。

Compilation 选项

• --target triple 为给定的体系结构构建。默认为主机架构。三元组的一般格式是<arch><sub>-<vendor>-<sys>-<abi>。 运行 rustc --print target-list以获取受支持目标的列表。可以多次指定该标志。
  这也可以用 build.target 配置值 https://doc.rust-lang.org/cargo/reference/config.html 来指定。
  注意，指定这个标志会使Cargo以不同的模式运行，其中目标工件被放在一个单独的目录中。有关更多详细信息，请参见构建缓存 https://doc.rust-lang.org/cargo/guide/build-cache.html 文档了解更多细节。

• -r, --release 使用发布profile文件构建优化的工件。另请参见 --profile 选项，通过名称选择特定的配置文件。

• --profile name 用给定的profile文件构建。请参阅参考文件 https://doc.rust-lang.org/cargo/reference/profiles.html 以了解有关配置文件的更多详细信息。

• --ignore-rust-version 构建目标，即使所选Rust编译器比项目的 rust-version` 字段中配置的所需Rust版本旧。

• --timings=fmts 输出每次编译需要多长时间的信息，并随着时间的推移跟踪并发信息。接受可选的逗号分隔的输出格式列表；不带参数的计时将默认为 --timings=html.。指定输出格式(而不是默认格式)是不稳定的，需要 -Zunstable-options。有效的输出格式:

  • html (不稳定，需要 -Zunstable-options)：将一个人类可读的文件cargo-timing.html写入target/cargo-timings目录，并附上编译报告。如果您想查看以前的运行，也可以在相同的目录下写一个带有时间戳的报告。HTML输出只适合人类使用，不提供机器可读的计时数据。
  • json(不稳定，需要 -Zunstable-options)：发出关于计时信息的机器可读JSON信息。

Output 选项

• --target-dir directory 所有生成的工件和中间文件的目录。也可以用CARGO_TARGET_DIR 环境变量或 build.target-dir 配置值 https://doc.rust-lang.org/cargo/reference/config.html 来指定。默认为工作空间根目录中的 target。

• --out-dir directory 将最终工件复制到此目录。此选项不稳定，仅在nightly channel 上可用，并且需要-Z不稳定选项标志才能启用。 见 https://github.com/rust-lang/cargo/issues/6790 以获取更多信息

Display 选项

• -v, --verbose 使用详细输出。对于包括额外输出(如依赖关系警告和构建脚本输出)的“very verbose(非常详细)”输出，可以指定两次。也可以用term.verbose配置值指定 https://doc.rust-lang.org/cargo/reference/config.html。

• -q, --quiet 不要打印 cargo 日志信息。也可以用term.quiet配置值指定。https://doc.rust-lang.org/cargo/reference/config.html

• --color when 控制何时使用彩色输出。有效值:

  • auto (默认)：自动检测终端是否支持颜色。
  • always：始终显示颜色。
  • never：从不显示颜色。

也可以用term.color配置值指定。 https://doc.rust-lang.org/cargo/reference/config.html

• --message-format fmt 诊断消息的输出格式。可以多次指定，由逗号分隔的值组成。有效值:

  • human (默认)： 以人类可读的文本格式显示。与short和json冲突。
  • short: 发出更短的、人类可读的文本消息。与human和json的冲突。
  • json: 向stdout发出JSON消息。详情见参考https://doc.rust-lang.org/cargo/reference/external-tools.html#json-messages。与人类的冲突和短暂。
  • json-diagnostic-short: 确保JSON消息的呈现字段包含来自rustc的“简短”呈现。不能与human或short一起使用。
  • json-diagnostic-rendered-ansi: 确保JSON消息的呈现字段包含嵌入的ANSI颜色代码，以符合rustc的默认颜色方案。不能与human或short一起使用。
  • json-render-diagnostics: 指示Cargo不要在打印的JSON消息中包含rustc诊断，而是Cargo本身应该呈现来自rustc的JSON诊断。Cargo自己的JSON诊断和来自rustc的其他诊断仍然会发出。不能与human或short一起使用。

• --build-plan 向stdout输出一系列JSON消息，指示运行构建的命令。此选项不稳定，仅在nightly channel https://doc.rust-lang.org/book/appendix-07-nightly-rust.html 可用，并且需要-Z unstable-options标志才能启用。请参阅 https://github.com/rust-lang/cargo/issues/5579>了解更多信息。

Manifest 选项

• --manifest-path path Cargo.toml文件的路径。默认情况下，Cargo在当前目录或任何父目录中搜索Cargo.toml文件。

• --frozen, --locked 这两个标志都要求Cargo.lock文件是最新的。如果锁文件丢失，或者需要更新，Cargo将出错退出。冻结标志还防止货物试图访问网络来确定它是否过期。
  在希望断言 Cargo.lock文件是最新的(例如CI构建)或希望避免网络访问的环境中，可以使用这些文件。

• --offline 防止货物以任何理由访问网络。如果没有这个标志，当Cargo需要访问网络而网络不可用时，Cargo将出错停止。有了这个标志，如果可能的话，货物将试图在没有网络的情况下前进。
  请注意，这可能会导致与在线模式不同的依赖关系解析。Cargo将自己限制在本地下载的板条箱中，即使在索引的本地副本中可能有更新的版本。请参阅cargo-fetch(1)命令，以便在脱机之前下载依赖项。

也可以用net.offline配置值来指定。https://doc.rust-lang.org/cargo/reference/config.html

Common 选项

• +toolchain 如果cargo已经安装了rustup，并且Cargo的第一个参数以+开头，它将被解释为rustup工具链名称(例如+stable或+nightly)。请参见 rustup 文档 https://rust-lang.github.io/rustup/overrides.html 获取有关工具链覆盖如何工作的更多信息。

• --config KEY=VALUE or PATH 覆盖货物配置值。该参数应该采用 KEY=VALUE 的 TOML 语法，或者作为额外配置文件的路径提供。可以多次指定该标志。请参阅命令行覆盖部分https://doc.rust-lang.org/cargo/reference/config.html#command-line-overrides了解更多信息。

• -C PATH

  • 在执行任何指定操作之前，更改当前工作目录。这将影响 cargo 在默认情况下在哪里查找项目清单(Cargo.toml),以及为了发现而搜索的目录。比如 cargo/config.toml。

  • 此选项仅在 nightly channel 和 上可用，并且需要-Z不稳定选项标志才能启用 (见 https://github.com/rust-lang/cargo/issues/10098)。

• -h, --help 打印帮助信息。

• -Z flag Cargo不稳定 (nightly-only) 标志。运行cargo -Z help获取详细信息。

Miscellaneous 选项

• -j N, --jobs N 要运行的并行作业的数量。也可以用build.jobs配置值指定 https://doc.rust-lang.org/cargo/reference/config.html。 默认为逻辑CPU的数量。如果为负，它将并行作业的最大数量设置为逻辑CPU的数量加上提供的值。不应为0。

• --keep-going 在依赖图中构建尽可能多的crates ，而不是在第一个构建失败时中止构建。不稳定，需要 ·-Zunstable-options·。

• --future-incompat-report 显示在执行此命令期间产生的任何未来不兼容警告的未来不兼容报告。

4.2 Rust 语言的编译器: rustc 工具

4.2.1 rustc 命令行语法格式

rustc [OPTIONS] INPUT

4.2.2 rustc 命令参数与选项解析