| aliases | tags | created | modified | ||
|---|---|---|---|---|---|
|
2023-01-30 03:19:11 -0800 |
2024-07-20 15:54:21 -0700 |
打开 Rust 官网，官方推荐下载 Rustup 并安装 Rust。
执行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 命令。
会显示以下的安装选项：
Current installation options:
default host triple: x86_64-unknown-linux-gnu
default toolchain: stable
profile: default
modify PATH variable: yes
1) Proceed with installation (default)
2) Customize installation
3) Cancel installation
1：默认设置
2：自定义安装
自定义安装中有一个「配置文件」选项，它是在安装 Rust toolchain 时，选择下载组件组。它有三个选项，一个 最小、默认 和 完整。
「最小」只有基本的：rustc rust-std 和 cargo。
「默认」在「最小」配置基础上加了 rust-docs、rustfmt 和 clippy。
「完整」包括了元数据中包含的所有组件。
3：取消安装
除非必要，一路默认！
安装成功，会显示以下信息：
Rust is installed now. Great!
To get started you may need to restart your current shell.
This would reload your PATH environment variable to include
Cargo's bin directory ($HOME/.cargo/bin).
To configure your current shell, run:
source $HOME/.cargo/env
根据提示，source 下，让 ~/.cargo/env 这个配置文件生效。
env 这个文件是将 cargo 配置到 PATH 环境变量中。
而如果安装选项选了 modify PATH variable: yes，.cargo/env 这个文件就会被配置到 .bashrc、.bash_profile、.profile 三个文件中：
. "$HOME/.cargo/env"windows 下可以通过 scoop 
scoop install rustup使用 scoop 安装的 rust，.rustup 和 .cargo 两目录是被放在 persist 目录下，也就是说就算重装 windows 系统，之前下载装的 rust 的工具仍在。
rustup 是一个 Rust 工具链安装器（the Rust toolchain installer），专门用于安装 Rust，也能对 Rust 进行管理：安装、升级、卸载等，还能切换版本。
[!info]
Rust 包括 stable、beta 和 nightly 三个版本。
rustup 命令：
rustup 1.24.3 (ce5817a94 2021-05-31)
The Rust toolchain installer
USAGE:
rustup [FLAGS] [+toolchain] <SUBCOMMAND>
FLAGS:
-v, --verbose Enable verbose output
-q, --quiet Disable progress output
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<+toolchain> release channel (e.g. +stable) or custom toolchain to set override
SUBCOMMANDS:
show Show the active and installed toolchains or profiles
update Update Rust toolchains and rustup
check Check for updates to Rust toolchains and rustup
default Set the default toolchain
toolchain Modify or query the installed toolchains
target Modify a toolchain's supported targets
component Modify a toolchain's installed components
override Modify directory toolchain overrides
run Run a command with an environment configured for a given toolchain
which Display which binary will be run for a given command
doc Open the documentation for the current toolchain
man View the man page for a given command
self Modify the rustup installation
set Alter rustup settings
completions Generate tab-completion scripts for your shell
help Prints this message or the help of the given subcommand(s)
DISCUSSION:
Rustup installs The Rust Programming Language from the official
release channels, enabling you to easily switch between stable,
beta, and nightly compilers and keep them updated. It makes
cross-compiling simpler with binary builds of the standard library
for common platforms.
If you are new to Rust consider running `rustup doc --book` to
learn Rust.
rustup 自我升级：
rustup self update升级组件：
rustup update安装组件：
rustup component add 组件名组件列表：
rustup component list具体查询 Rustup 文档 （Rustup Book）
Cargo 是 Rust 的构建和包管理器工具。
Cargo cli 工具负责运行构建、运行测试和准备项目以供发布。Rust 中的包被称为「crate」
crates.io 能查询各种各样的「crate」。
cargo build： 构建工程
cargo run： 运行工程
cargo clean： 清理 target 目录
cargo new： 创建一个 pakage
cargo init： 在一个存在的目录中创建 package
cargo update： 升级
cargo install： 安装一个 Rust 可执行程序到 .cargo/bin 目录中
cargo clippy： lint 工具
cargo fmt： 代码格式化
cargo tree： 查看第三方库的版本和依赖关系
cargo bench： 运行 benchmark（基准测试，性能测试）
cargo new 项目名称
创建一个新的程序，默认项目结构：main.rs 文件及 Cargo.toml 项目文件。
在新建的项目，git 已经初始化了。
在 .bashrc 或 .bash_profile 或 .zshrc 配置文件中添加以下配置：
export RUSTUP_UPDATE_ROOT="https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup"
export RUSTUP_DIST_SERVER="https://mirrors.tuna.tsinghua.edu.cn/rustup"[!tip] 国内镜像源
例子中用的是 清华的rustup镜像。
使用字节的源：
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"[!info] 相关资料
可以使用 CRM （ 「Cargo registry manager」 -- Cargo 注册表管理器）给 Cargo 换源。
安装 CRM：cargo install crm。
[!tip] 相关链接
crm list：列出可用的国内镜像源crm best：使用网络延迟最少的源crm current：查看当前镜像源crm default：恢复官方镜像crm test [name]：测试源。[name]，可以使用crm list列出源列表中得到。crm use <name>：切换源。crm remove <name>：删除源crm save <name> <addr> <dl>：在镜像配置文件中添加/更新镜像源
Rust 官方语言服务是 RLS （Rust Language Server）。
后来社区版的 rust-analyzer 被 Rust 「招安」成功，成为官方项目。
未来 原来的 RLS 会「退役」，而 rust-analyzer 将会成为官方的语言服务 --「rls-2.0」。
安装 rust-analyzer：
rustup update
rustup component add rust-analyzerrust-analyzer 需要标准库的源码，所以得把源码装上：
rustup component add rust-src理论上装上 rust-analyzer 就能使用这个 Rust 语言服务了。而装 rust-analyzer 可以通过操作系统软件包管理器装，也能通过 VSCode 的插件「顺道」安装。