如何在 Ubuntu 上配置 Rust

在 Ubuntu 上配置 Rust 的完整步骤

一 安装前准备

• 更新软件源并安装基础编译工具，确保后续能正常编译本地依赖与项目：
  • 命令：sudo apt update && sudo apt install -y curl build-essential gcc make
• 这些工具用于支持 Cargo 构建流程与常见本地库链接（如 linker ‘cc’ not found 的解决）。

二 安装与初始化 Rust 工具链（推荐 rustup）

• 使用 rustup 安装和管理工具链（稳定版、测试版、夜间版），这是 Rust 官方推荐方式：
  • 安装命令：curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 安装完成后执行：source $HOME/.cargo/env（或重启终端）以加载环境变量。
• 验证安装：
  • 命令：rustc --version、cargo --version
  • 成功示例：rustc 1.86.0、cargo 1.86.0（版本号会随时间变化）。
• 常用 rustup 管理：
  • 更新工具链：rustup update
  • 安装其他工具链：rustup toolchain install nightly
  • 切换默认工具链：rustup default nightly
  • 按需添加组件（如 rustfmt、clippy）：rustup component add rustfmt clippy。

三 国内网络加速（可选）

• 方式一（安装前设置环境变量，加速 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 下载）：
  • 编辑文件：~/.cargo/config.toml
  • 示例（中科大源）：
    • [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”
  • 也可使用清华源（示例）：
    • [registries]
      • crates-io = { index = “https://mirrors.tuna.tsinghua.edu.cn/crates.io-index” }
• 提示：若镜像不可用，请检查网络或更换可用镜像，并确认配置项书写正确。

四 创建项目与常用命令

• 使用 Cargo 快速创建与运行项目：
  • 新建二进制项目：cargo new hello_world
  • 进入目录：cd hello_world
  • 构建：cargo build
  • 运行：cargo run
  • 以上命令会生成可执行文件并直接运行示例程序。
• 直接使用 rustc 编译单文件：
  • 示例：rustc main.rs && ./main。

五 系统级安装与卸载（备选）

• 通过 APT 安装（版本通常较旧，适合系统统一管理）：
  • 安装：sudo apt install -y rustc cargo
  • 卸载：sudo apt remove --auto-remove rustc cargo
• 建议：开发场景优先使用 rustup，可灵活切换版本与组件；系统级安装适合对版本要求不高或需统一管控的环境。