Rust

rustup

相关概念

rustup 将 rustc 和 cargo等工具安装在 Cargo 的 bin 目录（Unix系统在$HOME/.cargo/bin，Windows系统在%USERPROFILE%.cargo\bin），但这些工具只是 Rust 工具链中组件的代理，真正工作的是工具链中的组件。通过 rustup 的命令可以指定使用不同版本的工具链。

与 rustup 相关的概念：

• channel —— Rust 发布在三个不同的"channel"上：stable，beta 和 nightly，其实就是三种不同的版本。
• toolchain —— 一套 Rust 组件，包括编译器及其相关工具，并且包含 channel，版本及支持的平台信息。
• target —— 指编译的目标平台，即：编译后的程序在哪种操作系统上运行。
• component —— toolchain 是由 component 组成的。
• profile —— 为了方便对 component 进行管理，使用 profile 定义一组 component。

Channels

Rust 发布在三个不同的"channel"上：

• stable版本 —— Rust 的稳定版本，每 6 周发布一次。
• beta版本 —— Rust 的公开测试版本，将是下一个stable版本。
• nightly版本 —— 每天更新，包含以一些实验性的新特性。 通过 rustup 相关命令可以选择使用不同版本的 Rust，默认安装的是 stable 版本。

# 切换到其他版本
rustup default stable/nightly/beta

Toolchains

工具链的标准命名格式：

<channel>[-<date>][-<host>]
 
<channel>       = stable|beta|nightly|<version>
<date>          = YYYY-MM-DD
<host>          = <target-triple>

工具链默认被安装在RUSTUP_HOME （Unix系统：~/.rustup ，Windows系统：%USERPROFILE%/.rustup）目录下。

# 查看所有工具链
rustup toolchain list

Components

工具链由若干组件构成，通过 rustup component list 命令可以查看所有可用和已经安装的组件。

rustup 默认安装的组件：

• rustc — Rust 编译器。
• rust-std — Rust 标准库。
• cargo — 包管理和构建工具，类似于 Java 的 Maven 和 Gradle。
• rust-docs — Rust 文档。
• rustfmt — 用来格式化 Rust 源代码。
• clippy — Rust 的代码检查工具。

Profiles

为了方便对 component 进行管理，使用 profile 定义一组 component。rustup 默认提供了三个 profile：

# 切换到minimal profile
rustup set profile minimal

cargo使用

常用的cargo命令

• 使用 cargo new 创建项目
• 使用 cargo run 构建并运行项目
• 使用 cargo check 快速检查代码是否可以通过编译
• 使用 cargo build 构建项目

主要命令详解 build, b 构建当前包 check, c 分析当前包并报告错误，但不构建目标文件 clean 删除构建的目录 doc, d 构建当前包及其依赖项目的文档（会创建 target/doc 目录，使用浏览器打开可以查看详细的文档） new 创建一个新的包 init 在现有目录中创建一个新的包 add 添加依赖项到当前项目中 remove 从当前项目中删除依赖项 run, r 构建并运行项目 test, t 运行测试 bench 运行基准测试 update 更新在 Cargo.lock 注册的依赖项版本 search 搜索 crates publish 打包并上传当前包 （crates.io） install 安装 Rust 二进制文件，默认目录在 $HOME/.cargo/bin uninstall 卸载 Rust 二进制文件 再补充几个 cargo 的重要子命令:

cargo clippy: 类似eslint，lint工具检查代码可以优化的地方 cargo fmt: 类似go fmt，代码格式化 cargo tree: 查看第三方库的版本和依赖关系 cargo bench: 运行benchmark(基准测试,性能测试) cargo udeps(第三方): 检查项目中未使用的依赖

# 创建项目
cargo new hello_cargo
 
cd hello_cargo

# 编译并运行项目(debug)
cargo run hello_cargo
 
# release模式
cargo run --release mytest
 
# 编译项目(release)
cargo build --release

在开发过程中，如果只是想快速检查代码是否通过编译，而不需要实际编译可执行文件，可以使用下面这个命令：

cargo check