Ubuntu Rust 工具链如何设置

Ubuntu 上设置 Rust 工具链

一 安装与准备

万事开头难？其实不然。在Ubuntu上搭建Rust开发环境，过程相当顺畅。咱们先从基础准备开始。

首先，确保系统是最新的，并安装一些基础的构建工具。放心，这些操作不需要root权限，用普通用户执行即可：

sudo apt update && sudo apt install -y curl build-essential gcc make

接下来，就是安装Rust的“大管家”——rustup。这是官方推荐的安装方式，能让你轻松管理多个Rust版本。只需一行命令：

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

执行后，脚本会询问安装选项。对于绝大多数用户，直接选择默认的 1) Proceed with installation 就行，它会安装最新的稳定版Rust以及包管理器Cargo。

安装完成后，需要让当前终端会话“认识”这些新命令。激活环境变量：

source $HOME/.cargo/env

最后，验证一下安装是否成功。分别运行以下两个命令，如果能看到版本号输出，恭喜你，第一步已经完美搞定：

rustc --version
cargo --version

这里有个关键点值得注意：rustup采用的是用户级安装。所有文件都放在你的家目录下（比如 ~/.cargo 和 ~/.rustup），完全不需要sudo权限。这种设计的好处显而易见——多版本共存与隔离变得轻而易举，也避免了污染系统目录。

二 配置工具链与常用操作

工具链装好了，就像拿到了一把好刀。接下来，咱们得熟悉一下怎么磨刀、换刀，让它用起来更顺手。

查看与切换工具链是rustup的核心功能。想看看自己装了哪些版本？rustup toolchain list 一目了然。除了稳定版（stable），Rust还有每夜构建版（nightly）和测试版（beta），想尝鲜新特性可以安装：rustup toolchain install nightly。如果想将某个版本设为默认，命令是 rustup default nightly。当然，你也可以只为某一次编译临时指定工具链：rustup run nightly cargo build。

组件与Profile 让你可以定制化工具链。一些提升开发效率的组件，比如代码检查工具 clippy、代码格式化工具 rustfmt、离线文档 rust-docs，都建议安装。此外，rustup提供了不同的预设配置（profile），可以通过 rustup show profile 查看当前配置，并用 rustup set profile 在 default（默认）、minimal（最小化）和 complete（完整）之间切换。

更新与自更新 是保持工具链健康的好习惯。一条命令更新所有已安装的工具链：rustup update。连rustup自身也能更新：rustup self update。

对于需要交叉编译的开发者，rustup同样提供了强大支持。先用 rustup show 看看你的默认主机平台（比如 x86_64-unknown-linux-gnu）。然后，可以添加其他目标平台，例如为ARM架构添加：rustup target add aarch64-unknown-linux-gnu。构建时指定目标即可：cargo build --target aarch64-unknown-linux-gnu。

三 国内镜像加速（可选）

如果你身处国内，可能会觉得从官方源下载速度不尽如人意。这时候，配置国内镜像就是一个立竿见影的提速方案。

方法很简单，在执行安装或更新命令之前，先设置两个环境变量：

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

如果已经安装好了rustup，后续进行更新操作时，也可以先设置这两个变量，再运行 rustup update，下载速度会有显著提升。

四 常见问题与排查

即使步骤再清晰，也难免会遇到一些小麻烦。这里列举几个常见问题及其解决方法。

问题一：编译时报错 linker ‘cc’ not found。
原因：这通常是缺少GCC链接器或基础构建工具套件。
解决：安装 build-essential 包即可：sudo apt install -y build-essential。

问题二：命令未找到（rustc/cargo）。
原因：终端没有加载Cargo的环境变量路径。
解决：可以临时执行 source $HOME/.cargo/env。但一劳永逸的办法是，将 export PATH="$HOME/.cargo/bin:$PATH" 这行添加到你的shell配置文件（~/.bashrc 或 ~/.zshrc）中，然后重新加载配置文件或新开一个终端。

问题三：需要离线查看文档。
解决：Rust的离线文档非常完善。安装 rust-docs 组件后，可以使用 rustup doc 打开主文档，rustup doc --book 打开《Rust程序设计语言》一书，rustup doc --std 打开标准库文档，随时随地查阅，无需网络。

五 卸载与系统级安装取舍

最后，聊聊如何“善后”，以及另一种安装方式的利弊。

如果你想卸载通过rustup安装的所有内容（用户级），操作非常彻底，直接删除两个目录就行：rm -rf ~/.cargo ~/.rustup。系统会变得干干净净，就像从没装过一样。

那么，为什么不直接用Ubuntu自带的包管理器安装呢？确实，你可以执行 sudo apt install -y rustc cargo 进行系统级安装。卸载也同样方便：sudo apt remove --auto-remove rustc cargo。

但这里必须指出，系统级安装通常不推荐用于日常开发。原因很简单：软件仓库中的Rust版本往往比较旧，无法及时获得语言的最新特性和安全更新。更重要的是，你失去了rustup带来的核心优势——灵活、无痛的多版本管理和一键更新。

因此，一个明确的建议是：对于Rust开发者，优先使用rustup进行用户级安装和管理。这才是跟上Rust快速迭代步伐的正确姿势。