Rust 在 Ubuntu 上如何配置

在 Ubuntu 上配置 Rust 的完整步骤

一 安装前准备

在开始安装 Rust 之前，有一步准备工作必不可少。这能帮你避开后续编译时可能遇到的常见错误，比如恼人的“cc 链接器未找到”问题。

具体来说，你需要更新系统包索引并安装基础的编译工具链。执行下面这条命令即可：

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

这一步的作用是为你提供 gcc、make 等核心构建工具，它们构成了大多数 Rust 项目顺利编译的基石。先把地基打牢，后面就顺畅了。

二 安装与初始化 Rust 工具链

接下来是主角登场。目前，通过 rustup 这个官方工具链管理器来安装 Rust，是社区公认的最佳实践。它不仅安装方便，未来管理多版本、更新卸载也都靠它。

安装稳定版（Stable）的命令非常简单：

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

运行脚本后，它会提示你进行选择。对于绝大多数用户，直接按回车，采用默认选项（安装 Stable 版本并包含 Cargo 包管理器）就是最稳妥的方案。

安装完成后，关键一步是激活环境变量。你可以立即执行：

source "$HOME/.cargo/env"

当然，更简单的办法是直接关闭并重新打开终端窗口。这样，cargo 和 rustc 等命令就会自动加入你的系统 PATH 了。

最后，别忘了验证一下安装是否成功。分别运行：

rustc --version
cargo --version

如果终端显示出类似 rustc 1.72.1 (2023-12-20) 和 cargo 1.72.1 (2023-12-20) 的版本信息，那么恭喜你，Rust 已经准备就绪。

三 国内镜像加速（可选）

对于国内开发者来说，网络环境有时会成为拦路虎。别担心，通过配置国内镜像源，下载速度可以得到显著提升。这里提供几种主流方案，你可以根据实际情况选择。

方式一：安装阶段临时加速
如果你还没执行安装脚本，可以先设置环境变量：

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

设置完成后，再运行之前的 curl | sh 安装命令，整个过程就会快很多。

方式二：安装后持久化配置
如果已经安装完成，但希望后续更新也能加速，可以将镜像配置写入你的 Shell 配置文件（如 ~/.profile 或 ~/.bashrc）：

echo 'export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static' >> ~/.profile
echo 'export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup' >> ~/.profile

写入后，执行 source ~/.profile 或重启终端生效。

方式三：配置 Cargo 包索引镜像
除了工具链，日常开发中下载依赖库（crate）也可能很慢。你可以为 Cargo 配置镜像。以清华大学开源软件镜像站为例，创建或编辑 ~/.cargo/config.toml 文件：

[registries]
crates-io = { index = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index" }

需要提醒的是，如果你使用的索引地址是 git:// 协议，请确保系统允许该协议，或者将其改为 https:// 协议，以避免连接问题。

四 常用配置与管理

安装只是第一步，高效地管理和使用 Rust 工具链同样重要。

工具链管理
Rust 支持多版本并存。你可以使用以下命令灵活切换：

• 查看已安装版本：rustup toolchain list
• 安装 Nightly 版本：rustup toolchain install nightly
• 将 Nightly 设为默认：rustup default nightly
• 仅为单次命令使用指定工具链：rustup run nightly cargo build

组件与 Profile
Rustup 提供了不同的预置配置（Profile），以平衡安装大小和功能完整性：

• 查看当前配置：rustup show profile
• minimal：仅包含 rustc、cargo 和标准库，最精简。
• default：推荐选择，额外包含文档、代码格式化工具 rustfmt 和 lint 工具 Clippy。
• complete：包含所有组件。

更新与卸载
保持工具链更新可以获取最新功能和修复：rustup update
如果需要卸载整个 Rust 环境，一条命令即可干净移除：rustup self uninstall

常用开发命令
现在，你可以开始体验 Rust 开发了：

• 创建新项目：cargo new hello_world && cd hello_world
• 构建项目：cargo build
• 运行项目：cargo run
• 快速检查代码（不生成可执行文件）：cargo check，这在开发中非常高效。

五 常见问题与排查

即便按照步骤操作，偶尔也可能遇到小麻烦。这里列出两个最常见的问题及其解决方案。

问题一：编译时报错 “linker ‘cc’ not found”
原因：这个错误表明系统缺少 GNU 编译器集合（GCC）等基础编译工具。
解决：即便你在准备阶段已经安装，有时也可能遗漏。请确保执行：sudo apt install -y build-essential

问题二：安装或更新极其缓慢，甚至失败
原因：这通常是由于网络连接至官方服务器不畅所致。
解决：请回头仔细检查本章节“国内镜像加速”部分。确认是否正确设置了 RUSTUP_DIST_SERVER 与 RUSTUP_UPDATE_ROOT 环境变量，或者是否配置了 Cargo 镜像。尝试切换为中国科学技术大学（USTC）或清华大学（Tuna）的镜像源后重试，问题大多能迎刃而解。