如何在 Ubuntu 上配置 Rust

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 --version
• cargo --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-static
  • export 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 版本要求固定、或需要由系统包管理器统一维护的环境。