Ubuntu Rust 工具链如何设置

Ubuntu 上设置 Rust 工具链

一 安装与准备

• 更新系统并安装基础构建工具（非 root 用户执行即可）：
  • sudo apt update && sudo apt install -y curl build-essential gcc make
• 使用官方安装脚本安装 rustup（Rust 工具链管理器）：
  • curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 安装时选择默认 1) Proceed with installation（稳定版 + Cargo）
• 激活环境（当前会话生效）：
  • source $HOME/.cargo/env
• 验证安装：
  • rustc --version
  • cargo --version
• 说明：rustup 会将工具链安装到用户目录（如 ~/.cargo、~/.rustup），无需 sudo，便于多版本共存与隔离。

二 配置工具链与常用操作

• 查看与切换工具链：
  • 查看：rustup toolchain list
  • 安装其他渠道：rustup toolchain install nightly（或 beta）
  • 设为默认：rustup default nightly
  • 临时使用某工具链运行命令：rustup run nightly cargo build
• 组件与 Profile：
  • 常用组件：clippy（代码检查）、rustfmt（格式化）、rust-docs（文档）
  • 查看/切换 profile：rustup show profile；rustup set profile default | minimal | complete
• 更新与自更新：
  • 更新所有工具链：rustup update
  • 更新 rustup 自身：rustup self update
• 目标三元组与交叉编译（示例）：
  • 查看默认主机：rustup show（如 x86_64-unknown-linux-gnu）
  • 安装目标：rustup target add aarch64-unknown-linux-gnu
  • 交叉构建：cargo build --target aarch64-unknown-linux-gnu。

三 国内镜像加速（可选）

• 设置环境变量后再执行安装或更新，可显著加速下载：
  • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
  • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
• 若已安装，可先设置变量再运行：rustup update。

四 常见问题与排查

• 编译时报错 linker ‘cc’ not found：
  • 原因：缺少 GNU 链接器/构建工具
  • 解决：sudo apt install -y build-essential
• 命令未找到（rustc/cargo）：
  • 原因：未加载 cargo 环境
  • 解决：执行 source $HOME/.cargo/env，或将 export PATH=“$HOME/.cargo/bin:$PATH” 加入 ~/.bashrc 或 ~/.zshrc 并重新加载
• 需要离线文档：
  • 本地查看：rustup doc；rustup doc --book；rustup doc --std。

五 卸载与系统级安装取舍

• 卸载 rustup 与工具链（用户级）：
  • rm -rf ~/.cargo ~/.rustup
• 系统级安装（不推荐，版本通常较旧）：
  • 安装：sudo apt install -y rustc cargo
  • 卸载：sudo apt remove --auto-remove rustc cargo
• 建议：日常开发优先使用 rustup，便于多版本管理与快速更新。