Rustup 安装指南:从入门到精通
前言
Rustup 是 Rust 编程语言的官方工具链管理工具,它不仅能安装 Rust 编译器(rustc)和包管理器(cargo),还能轻松管理多个 Rust 版本和工具链。本文将详细介绍 Rustup 的安装过程及相关配置,帮助开发者快速搭建 Rust 开发环境。
基础安装
安装 Rustup 最简单的方式是使用官方提供的安装脚本。安装完成后,系统会自动配置以下内容:
-
将 Rust 工具链安装到默认目录:
- Unix 系统:
$HOME/.cargo/bin
- Windows 系统:
%USERPROFILE%\.cargo\bin
- Unix 系统:
-
自动将该目录添加到系统的 PATH 环境变量中
安装完成后,建议打开一个新的终端窗口,执行以下命令验证安装是否成功:
rustc --version
如果看到类似 rustc 1.68.0 (2c8cc3432 2023-03-06)
的输出,说明安装成功。
自定义安装路径
对于需要自定义安装位置的用户,Rustup 提供了两个关键环境变量:
RUSTUP_HOME
:指定 Rustup 的根目录,用于存储安装的工具链和配置CARGO_HOME
:指定 Cargo 的主目录,包含缓存和依赖文件
设置方法示例(Linux/macOS):
export RUSTUP_HOME=/path/to/rustup
export CARGO_HOME=/path/to/cargo
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
注意:设置自定义路径后,需要确保这些环境变量始终可用,并且 $CARGO_HOME/bin
在系统的 PATH 环境变量中。
安装特定版本工具链
Rustup 支持安装多个 Rust 版本,包括稳定版(stable)、测试版(beta)和开发版(nightly)。
安装 nightly 版本
安装 nightly 版本时,默认会强制安装最新版本,可能缺少某些组件。如果需要特定组件,建议分两步安装:
- 先安装 Rustup 但不安装工具链:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-toolchain none -y
- 再安装带有特定组件的 nightly 工具链:
rustup toolchain install nightly --allow-downgrade --profile minimal --component clippy
这种方法特别适合 CI/CD 环境,可以确保获得包含所需组件的最新可用工具链。
Shell 自动补全
Rustup 支持为多种 shell 生成自动补全脚本,可以大大提高开发效率。
Bash 配置
# Linux
rustup completions bash > ~/.local/share/bash-completion/completions/rustup
# macOS (Homebrew)
rustup completions bash > $(brew --prefix)/etc/bash_completion.d/rustup.bash-completion
Fish 配置
mkdir -p ~/.config/fish/completions
rustup completions fish > ~/.config/fish/completions/rustup.fish
Zsh 配置
rustup completions zsh > ~/.zfunc/_rustup
然后在 ~/.zshrc
文件中 compinit
之前添加:
fpath+=~/.zfunc
PowerShell 配置
rustup completions powershell >> $PROFILE.CurrentUserCurrentHost
# 或者
rustup completions powershell | Out-String | Invoke-Expression
配置完成后,需要重启终端使更改生效。
卸载 Rust
如果不再需要 Rust 开发环境,可以完全卸载:
rustup self uninstall
结语
通过本文的介绍,你应该已经掌握了 Rustup 的安装和基本配置方法。Rustup 的强大之处在于它能轻松管理多个 Rust 版本和工具链,为开发者提供了极大的灵活性。建议进一步探索 Rustup 的其他功能,如工具链管理、组件安装等,以充分发挥 Rust 生态系统的潜力。