Rust在Ubuntu上如何配置环境

在 Ubuntu 上配置 Rust 环境

一 安装前准备

• 更新索引并安装基础编译工具，确保后续能编译本地依赖与构建项目：
  • 命令：sudo apt update && sudo apt install -y curl build-essential gcc make
• 建议使用非 root 用户安装与开发，避免对系统范围产生影响。

二 安装与激活 Rust 工具链

• 使用 rustup 安装（推荐，便于多版本管理与更新）：
  • 安装命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 安装时选择默认配置（通常为安装稳定版 Stable与 Cargo）。
  • 激活环境：source "$HOME/.cargo/env"（或重新打开终端）。
  • 验证版本：
    • rustc -Vv（查看编译器版本与详细信息）
    • cargo -V（查看包管理器版本）
• 备选方式（系统包管理器安装）：
  • 命令：sudo apt install -y rustc cargo
  • 特点：版本通常较旧，适合系统级统一管理与简单使用。

三 国内镜像加速（可选）

• 加速工具链安装（rustup）：
  • 在运行安装脚本前设置环境变量：
    • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
    • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
  • 然后再执行 curl ... | sh 开始安装。
• 加速依赖下载（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
  • 运行：cargo run
  • 仅用编译器运行单文件：rustc main.rs && ./main
• 常用维护命令：
  • 更新工具链：rustup update
  • 切换工具链（如 nightly）：rustup install nightly && rustup default nightly
  • 卸载（rustup 安装方式）：rustup self uninstall

五 常见问题与排查

• 编译报错 linker ‘cc’ not found：
  • 原因：缺少 GNU 编译工具链。
  • 解决：sudo apt install -y build-essential
• 安装或更新缓慢：
  • 检查是否已设置 RUSTUP_DIST_SERVER 与 RUSTUP_UPDATE_ROOT，或确认 ~/.cargo/config.toml 镜像配置正确。