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）的镜像源后重新尝试安装或更新，通常能解决此问题。
