Rust 在 Ubuntu 上如何配置

Ubuntu 系统安装 Rust 编程语言详细教程

一、安装前的准备工作

在 Ubuntu 中安装 Rust 之前，进行必要的系统准备至关重要。这一步能有效预防后续编译过程中可能出现的“cc 链接器未找到”等典型错误，确保安装过程顺畅无阻。

核心操作是更新软件包列表并安装基础的编译工具链。在终端中执行以下命令：

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

此命令的作用是为系统安装 gcc 编译器、make 构建工具等核心组件，它们是 Rust 项目成功编译和运行的底层依赖。预先打好这个基础，后续安装将事半功倍。

二、安装与配置 Rust 工具链

接下来进入核心安装环节。通过官方工具 rustup 来安装 Rust 是目前最推荐的方式。它不仅能便捷地安装稳定版，还方便未来管理多个 Rust 版本、进行更新和卸载。

安装 Rust 稳定版（Stable）的命令如下：

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

运行上述脚本后，会进入交互式安装界面。对于大多数初次安装的用户，直接按回车键选择默认选项（安装稳定版并包含 Cargo 包管理器）是最佳选择。

安装完成后，必须激活环境变量才能使 Rust 命令生效。你可以立即执行：

source "$HOME/.cargo/env"

更简便的方法是直接关闭当前终端窗口并重新打开一个新的。这样，cargo、rustc 等命令就会自动添加到系统的 PATH 环境变量中。

最后，通过以下命令验证 Rust 和 Cargo 是否安装成功：

rustc --version
cargo --version

如果终端正确输出版本号信息，例如 rustc 1.72.1 (2023-12-20) 和 cargo 1.72.1 (2023-12-20)，则表明 Rust 开发环境已在你的 Ubuntu 系统上成功部署。

三、配置国内镜像加速（可选优化）

对于身处国内的开发者，访问 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 安装命令，下载速度将得到显著改善。

方案二：安装后永久配置镜像源
若 Rust 已安装完毕，但希望后续更新也能加速，可将镜像配置写入 Shell 的启动文件（如 ~/.bashrc 或 ~/.zshrc）：

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

保存后，执行 source ~/.bashrc 或重启终端使配置生效。

方案三：配置 Cargo 依赖包镜像
日常开发中，Cargo 下载 crate（依赖包）也可能需要加速。可以配置 Cargo 使用国内镜像索引。以清华大学镜像站为例，创建或编辑 ~/.cargo/config.toml 文件：

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

请注意，如果镜像索引地址使用 git:// 协议，请确保系统支持该协议，或将其更改为 https:// 协议，以避免潜在的连接问题。

四、常用工具链管理与开发配置

成功安装 Rust 后，掌握其工具链的管理和常用开发命令，能让你更高效地进行 Rust 编程。

工具链版本管理
Rustup 支持安装和管理多个 Rust 版本。常用命令如下：

• 列出所有已安装的工具链：rustup toolchain list
• 安装 Nightly（ nightly ）版本：rustup toolchain install nightly
• 将 Nightly 版本设置为默认：rustup default nightly
• 为单次命令指定使用的工具链：rustup run nightly cargo build

安装配置档（Profile）选择
Rustup 提供了不同的预置配置档，以适配不同需求：

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

更新与卸载
更新所有已安装的工具链至最新版本：rustup update
如需从系统中彻底移除 Rust 环境，可使用：rustup self uninstall

基础开发命令
现在，你可以开始你的第一个 Rust 项目了：

• 创建新项目：cargo new my_project && cd my_project
• 编译项目：cargo build
• 编译并运行项目：cargo run
• 快速检查代码语法（不编译）：cargo check，这在开发迭代中能极大提升效率。

五、常见安装问题与解决方法

即使遵循教程，安装过程中也可能遇到一些问题。以下是两个最常见问题的排查思路。

问题一：编译时出现 “linker ‘cc’ not found” 错误
原因分析：此错误表明系统缺少必要的 C 语言编译工具链（GCC）。
解决方案：请确保已正确安装 build-essential 包。可以再次运行：sudo apt install -y build-essential 进行修复。

问题二：安装或更新 Rust 时速度极慢或失败
原因分析：这通常是由于网络连接至 Rust 官方服务器不稳定或速度受限导致。
解决方案：请严格按照本文“配置国内镜像加速”章节的指引进行操作。仔细检查 RUSTUP_DIST_SERVER 和 RUSTUP_UPDATE_ROOT 环境变量是否设置正确，或 Cargo 镜像是否已配置。尝试切换为中国科学技术大学（USTC）或清华大学（Tuna）的镜像源后重新尝试安装或更新，通常能解决此问题。