怎样配置 Ubuntu Rust 编译器

Ubuntu 系统安装与配置 Rust 编译环境的完整指南

一、安装前的环境准备

在 Ubuntu 上安装 Rust 编译器之前，预先配置好基础的编译环境至关重要。这一步能有效预防后续可能出现的“linker ‘cc’ not found”等常见编译错误，确保安装过程顺畅无阻。

• 更新软件源并安装核心构建工具（普通用户权限执行即可）：
  • sudo apt update && sudo apt install -y curl build-essential gcc make

此命令安装了包括 gcc、make 在内的核心编译工具链，为 Rust 的顺利运行搭建了必要的底层“基础设施”。

二、安装与配置 Rust 工具链

通过 rustup 工具链管理器安装 Rust 是目前最受推崇的方式。它不仅能便捷地管理多个 Rust 版本，还为交叉编译等高级应用场景提供了强大支持。

• 使用官方脚本安装 rustup：
  • curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh

执行脚本后，选择默认选项 1) Proceed with installation (default) 完成安装。安装结束后，必须执行以下命令来激活当前 Shell 的 Rust 环境：

• source $HOME/.cargo/env

随后，通过以下命令验证安装是否成功：

• 检查 Rust 编译器版本：rustc -V（预期输出类似：rustc 1.72.1）
• 检查 Cargo 包管理器版本：cargo -V

掌握几个常用的维护命令将让你事半功倍：

• 更新 Rust 工具链至最新稳定版：rustup update
• 彻底卸载 Rust：rustup self uninstall

值得注意的是，rustup 采用用户级安装，所有文件均位于用户主目录（如 ~/.rustup 和 ~/.cargo/bin），无需 sudo 权限。这种设计实现了环境的完美隔离，并支持多个 Rust 版本并行共存。

三、配置国内镜像加速（可选但推荐）

对于身处国内的开发者，配置镜像源可以极大提升 Rust 工具链和依赖包的下载速度，改善开发体验。配置主要涉及安装过程和使用过程两个方面。

• 安装阶段加速：在运行安装脚本前，先设置以下环境变量以使用国内镜像：
  • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
  • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

日常开发中，为了加速 Cargo 拉取 crate（包）的速度，需要配置 Cargo 的镜像源：

• 创建或编辑配置文件：~/.cargo/config.toml
• 以配置清华大学 TUNA 镜像源为例，添加如下内容：
  • [registries]
    • crates-io = { index = “https://mirrors.tuna.tsinghua.edu.cn/crates.io-index” }

请注意，镜像地址可能发生变更。若遇到加速失效的情况，可尝试更换为中国科学技术大学（USTC）等其它可用镜像源，或暂时切换回官方源进行问题诊断。

四、创建首个 Rust 项目并运行

环境配置完成后，即可开始体验 Rust 的开发工作流。以下介绍两种入门方式。

第一种是使用 Cargo 这一 Rust 官方集成的项目管理和构建工具，它是 Rust 生态中的标准实践：

• 创建新项目并进入目录：cargo new hello_world && cd hello_world
• 编译项目：cargo build（生成的可执行文件位于 target/debug/ 目录）
• 编译并立即运行项目：cargo run
• 编译发布优化版本：cargo build --release（优化后的二进制文件位于 target/release/）

第二种方式更为轻量，适合快速编写和测试单个 Rust 文件：

• 创建一个简单的 Rust 程序文件：echo ‘fn main(){println!(“Hello, Rust”);}’ > main.rs
• 直接使用 rustc 编译器编译并运行：rustc main.rs && ./main

五、常见问题排查与进阶配置

在 Ubuntu 上配置和使用 Rust 时，你可能会遇到一些典型问题。本节将集中解答，并介绍一些提升开发效率的扩展功能。

• 链接器缺失错误：若编译时提示 “linker ‘cc’ not found”，请返回第一步，确认已成功安装 build-essential 软件包组。
• 通过系统包管理器安装（备选方案）：
  • 命令：sudo apt install -y rustc cargo

  通过 Ubuntu 官方仓库安装的 Rust 版本可能不是最新的，适用于对版本要求不高、或希望由系统统一管理所有软件的场景。若需使用最新特性或灵活切换版本，rustup 安装方式仍是首选。

• 配置交叉编译环境：Rust 拥有卓越的交叉编译支持，配置过程非常简洁。
  • 列出所有支持的目标平台：rustup target list
  • 为特定目标安装标准库（例如为 RISC-V 裸机环境）：rustup target add riscv32imac-unknown-none-elf
  • 针对该目标平台进行构建：cargo build --target riscv32imac-unknown-none-elf
• 安装常用开发工具组件（按需）：为了提升开发与调试效率，可以考虑安装以下扩展工具。
  • cargo install cargo-binutils（集成 LLVM 工具）
  • rustup component add llvm-tools-preview（预览版 LLVM 工具链）