Ubuntu 系统安装与配置 Rust 开发环境完整指南
一、安装前的系统环境准备
在开始安装 Rust 之前，确保 Ubuntu 系统环境准备就绪至关重要。首先需要更新软件源并安装基础的编译工具链。这一步虽然简单，但能有效预防后续编译 Rust 项目或其本地依赖时，出现“linker ‘cc’ not found”等常见编译错误，为顺利安装 Rust 铺平道路。
- 通过执行以下命令一次性完成准备工作：
sudo apt update && sudo apt install -y curl build-essential gcc make
这些基础开发工具将为 Cargo 构建流程以及链接本地系统库提供核心支持。
二、安装与初始化 Rust 工具链（官方推荐 rustup）
接下来是核心安装环节。Rust 官方推荐使用 rustup 工具链管理器进行安装。它的最大优势在于可以便捷地管理多个 Rust 版本（如稳定版、测试版、夜间版），并支持在不同版本间灵活切换，非常适合开发与测试需求。
- 安装过程仅需一条命令：
curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
脚本执行完成后，需要加载环境变量以使 rustc 和 cargo 命令生效。可以执行 source $HOME/.cargo/env，或者直接关闭并重新打开终端窗口。
如何验证 Rust 是否安装成功？在终端中运行以下命令检查版本：
rustc --versioncargo --version
如果看到类似 rustc 1.86.0 和 cargo 1.86.0 的输出（具体版本号会更新），则表明 Rust 开发环境已配置成功。
rustup 的功能远不止安装。作为强大的管理工具，以下是一些常用命令：
- 更新整个 Rust 工具链：
rustup update - 安装其他版本（如夜间版）：
rustup toolchain install nightly - 切换默认工具链版本：
rustup default nightly - 安装实用组件，如代码格式化工具和静态分析工具：
rustup component add rustfmt clippy
三、国内网络环境加速配置（可选优化）
对于身处国内的开发者，访问 Rust 官方源可能遇到网络延迟问题。为此，我们可以配置国内镜像源来显著提升下载速度。主要提供两种加速方案。
方案一：加速 rustup 安装过程。
此方法通过设置环境变量，将 rustup 的下载源指向国内镜像服务器。
- 在终端中依次执行以下命令：
export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-staticexport RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
设置好环境变量后，再执行前述的 rustup 安装命令，下载速度将得到明显改善。
方案二：配置 Cargo 国内镜像，加速依赖包下载。
日常开发中，从 crates.io 下载依赖库（crate）更为频繁。通过配置 Cargo 镜像可以极大提升效率。
- 创建或编辑 Cargo 的配置文件：
~/.cargo/config.toml - 以配置中科大（USTC）镜像源为例，添加以下内容：
[source.crates-io]registry = “https://github.com/rust-lang/crates.io-index”replace-with = ‘ustc’
[source.ustc]registry = “git://mirrors.ustc.edu.cn/crates.io-index”
- 也可以使用清华大学（Tuna）镜像源，配置示例如下：
[registries]crates-io = { index = “https://mirrors.tuna.tsinghua.edu.cn/crates.io-index” }
请注意，镜像地址可能发生变更。如果遇到依赖下载失败，请检查网络连接、尝试更换其他可用镜像源，并仔细核对配置文件格式是否正确。
四、创建 Rust 项目与常用 Cargo 命令
环境配置完成后，即可开始 Rust 编程。Rust 的官方包管理器和构建工具 Cargo 极大地简化了项目创建、构建和依赖管理流程。
使用 Cargo 快速创建一个新项目：
- 创建一个新的二进制（可执行）项目：
cargo new hello_world - 进入项目目录：
cd hello_world - 编译构建项目：
cargo build - 编译并直接运行项目：
cargo run
执行 cargo run 时，Cargo 会自动完成编译并运行生成的可执行文件，终端将输出经典的 “Hello, world!”。
对于单个 Rust 源文件，也可以直接使用 Rust 编译器 rustc 进行编译：
- 示例：
rustc main.rs && ./main
五、通过 APT 进行系统级安装与卸载（备用方案）
除了使用 rustup，Ubuntu 系统的 APT 软件仓库也提供了 Rust 软件包。但请注意，此方式安装的版本通常不是最新的稳定版，可作为备用方案。
- 通过 APT 安装：
sudo apt install -y rustc cargo - 通过 APT 卸载：
sudo apt remove --auto-remove rustc cargo
如何选择安装方式？对于大多数 Rust 开发者，强烈推荐使用 rustup，因为它提供了版本管理的灵活性和便捷的组件管理。而通过 APT 进行系统级安装，则更适合对 Rust 版本要求固定、或需要由系统包管理器统一维护的环境。
