怎样配置 Ubuntu Rust 编译器

Ubuntu 配置 Rust 编译器的推荐步骤

一 安装前准备

在正式安装 Rust 之前，先打好基础环境是事半功倍的做法。这能有效避免后续出现诸如 “linker ‘cc’ not found” 这类令人头疼的错误。

• 更新索引并安装基础构建工具（非 root 用户执行即可）：
  • sudo apt update && sudo apt install -y curl build-essential gcc make

这一步提供了 gcc、ld 等核心链接器与基础的编译环境，相当于为 Rust 的入住提前装修好了“毛坯房”。

二 安装与激活 Rust 工具链

目前社区最推荐的方式是使用 rustup 进行安装。它的优势在于能轻松管理多个 Rust 版本，并且对交叉编译的支持非常友好。

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

运行脚本后，选择默认选项 1) Proceed with installation (default) 即可。安装完成后，别忘记执行以下命令来激活环境：

• source $HOME/.cargo/env

接下来，验证一下安装是否成功：

• 查看 Rust 编译器版本：rustc -V（示例输出：rustc 1.72.1）
• 查看 Cargo 包管理器版本：cargo -V

几个常用的维护命令也值得记下：

• 更新工具链：rustup update
• 卸载：rustup self uninstall

值得一提的是，rustup 会将所有工具链安装到你的用户目录下（例如 ~/.rustup 和 ~/.cargo/bin），整个过程不需要 sudo 权限。这种设计既实现了环境隔离，也为多版本共存提供了可能。

三 国内镜像加速（可选）

对于国内开发者而言，配置镜像加速能显著提升下载速度，让体验更加流畅。配置主要分两个阶段：安装阶段和日常使用阶段。

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

然后是日常的包索引和下载加速，这需要通过修改 Cargo 的配置文件来实现：

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

需要提醒的是，镜像地址有时会进行调整。如果发现加速失效，可以尝试更换为其他可用镜像，或者暂时恢复官方源进行排查。

四 创建项目与构建运行

环境配置妥当，是时候体验一下 Rust 的开发流程了。这里有两种常见的起步方式。

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

• 新建项目并进入目录：cargo new hello_world && cd hello_world
• 编译项目：cargo build（调试版可执行文件会生成在 target/debug/ 目录下）
• 编译并直接运行：cargo run
• 编译发布优化版：cargo build --release（输出位于 target/release/）

第二种方式更为直接，适合快速测试单个文件：

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

五 常见问题与扩展

在配置和使用过程中，可能会遇到一些典型问题。这里做个集中梳理，并介绍一些扩展能力。

• 链接器缺失：如果编译时报错 “linker ‘cc’ not found”，回头检查第一步，确保已经安装了 build-essential 包。
• 系统包管理器安装（备选方案）：
  • 命令：sudo apt install -y rustc cargo

  这种方式安装的版本通常不是最新的，适合只需要基础功能，或者希望由系统统一管理软件的场景。如果你需要体验最新特性或灵活管理工具链，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
  • rustup component add llvm-tools-preview