Rust在Ubuntu中如何配置

在 Ubuntu 上配置 Rust 的完整步骤

一 安装前准备

• 更新系统并安装基础编译工具，确保后续能正常编译 Rust 项目：
  • 命令：sudo apt update && sudo apt install -y curl build-essential gcc make
  • 作用：安装 curl（下载工具）与 build-essential/gcc/make（GNU 工具链），解决常见的链接器缺失问题（如报错 linker ‘cc’ not found）。

二 安装与配置 Rust 工具链

• 推荐方式：使用 rustup（官方工具链管理器，支持多版本并存与一键更新）
  • 安装命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 安装时选择默认项（安装 stable 工具链与 Cargo）。
  • 激活环境：source $HOME/.cargo/env（或新开一个终端会话）。
  • 验证安装：rustc --version、cargo --version 应输出版本号。
  • 中国大陆加速（可选，二选一或同时使用）：
    • 设置环境变量（安装前或安装后执行均可）：
      • 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" }
      • 或使用 中国科学技术大学 镜像（覆盖默认源）：
        • [source.crates-io]
        • replace-with = 'ustc'
        • [source.ustc]
        • registry = "git://mirrors.ustc.edu.cn/crates.io-index"
  • 备选方式：使用系统包管理器安装（版本通常较旧，适合统一系统管理）
    • 安装命令：sudo apt install -y rustc cargo
    • 卸载命令：sudo apt remove cargo && sudo apt autoremove
  • 常用维护：
    • 更新工具链：rustup update
    • 卸载 rustup（官方方式）：rustup self uninstall。

三 创建与运行第一个项目

• 使用 Cargo 快速创建并运行项目：
  • 创建二进制项目：cargo new hello_world && cd hello_world
  • 构建项目：cargo build（产物在 target/debug/）
  • 运行项目：cargo run
  • 仅编译运行（不生成可执行文件到当前目录）：cargo run --release（产物在 target/release/）
• 直接使用 rustc 编译单文件：
  • 示例：rustc main.rs && ./main。

四 常见问题与排查

• 编译时报错 linker ‘cc’ not found：安装 build-essential（或 sudo apt install gcc）。
• 下载速度慢或失败：检查并设置 RUSTUP_DIST_SERVER / RUSTUP_UPDATE_ROOT 环境变量，或在 ~/.cargo/config.toml 中配置 crates.io 镜像源；必要时执行 cargo update 刷新索引。
• 安装后 rustc/cargo 不可用：确认已执行 source $HOME/.cargo/env，或重新打开终端；若使用系统包管理器安装，注意其版本可能较旧。