怎样配置 Ubuntu Rust 编译器

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

一 安装前准备

• 更新索引并安装基础构建工具（非 root 用户执行即可）：
  • sudo apt update && sudo apt install -y curl build-essential gcc make
• 这些依赖提供 gcc/ld 等链接器与基础编译环境，避免后续出现 “linker ‘cc’ not found” 等错误。

二 安装与激活 Rust 工具链

• 使用 rustup 安装（推荐，便于多版本与交叉编译管理）：
  • curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 安装时选择默认 1) Proceed with installation (default)；完成后执行：source $HOME/.cargo/env
• 验证安装：
  • rustc -V（示例输出：rustc 1.72.1）
  • 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” }
• 提示：镜像地址可能随时间调整，失效时请更换为可用镜像或恢复官方源。

四 创建项目与构建运行

• 使用 Cargo 新建并运行项目：
  • cargo new hello_world && cd hello_world
  • cargo build（生成调试版于 target/debug/）
  • cargo run（构建并运行）
  • cargo build --release（生成发布版于 target/release/）
• 直接使用 rustc 编译单文件：
  • echo ‘fn main(){println!(“Hello, Rust”);}’ > main.rs
  • rustc main.rs && ./main

五 常见问题与扩展

• 链接器缺失：若报错 “linker ‘cc’ not found”，安装 build-essential（见第一步）。
• 系统包管理器安装（备选，版本通常较旧）：
  • sudo apt install -y rustc cargo
  • 适合只需基础功能或系统级统一管理的场景；如需最新特性与工具链管理，仍建议使用 rustup。
• 交叉编译示例（添加目标三元组后构建）：
  • 查看可用目标：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