Ubuntu 下 Rust 配置步骤是什么

Ubuntu 下 Rust 配置步骤

一 准备与安装

• 更新系统并安装编译工具链（确保后续能编译本地依赖）：
  • 命令：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
  • 安装时选择默认选项（安装 stable 工具链与 Cargo）。
• 激活环境：
  • 命令：source "$HOME/.cargo/env"（或新开一个终端会话）。
• 验证安装：
  • 命令：rustc --version、cargo --version、rustup --version，应显示版本号与路径 $HOME/.cargo/bin。

二 国内镜像加速（可选）

• 安装阶段加速（设置环境变量后再执行安装脚本）：
  • 命令：
    • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
    • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
• 包索引与下载加速（配置 Cargo 镜像）：
  • 编辑或创建文件：$HOME/.cargo/config.toml
  • 示例（使用 清华大学 镜像）：
    • 内容：

      [registries]
        crates-io = { index = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index" }
      

  • 说明：镜像能显著提升 crates.io 索引与依赖下载速度，适合中国大陆网络环境。

三 基础配置与管理

• 工具链管理（使用 rustup）：
  • 查看：rustup toolchain list
  • 安装其他工具链（如 nightly）：rustup toolchain install nightly
  • 切换默认工具链：rustup default nightly
  • 临时使用某工具链运行命令：rustup run nightly cargo build
• 组件与 Profile：
  • 常用组件：rustfmt（格式化）、clippy（代码检查）、rust-docs（文档）
  • 查看/切换 Profile：rustup show profile，可选 minimal、default、complete
  • 按需安装组件示例：rustup component add clippy rustfmt
• 常用维护：
  • 更新工具链：rustup update
  • 卸载 Rust：rustup self uninstall

四 创建项目与构建运行

• 使用 Cargo 创建并运行项目：
  • 新建二进制项目：cargo new hello_world && cd hello_world
  • 构建：cargo build
  • 运行：cargo run
  • 发布构建：cargo build --release
• 直接使用 rustc 编译单文件：
  • 示例：rustc main.rs && ./main

五 常见问题与排查

• 编译报错 linker ‘cc’ not found：
  • 原因：缺少 GNU 编译器工具链。
  • 解决：sudo apt install -y build-essential
• 命令未找到（如 rustc、cargo）：
  • 原因：环境变量未生效。
  • 解决：source "$HOME/.cargo/env"，或确认 echo "$PATH" 包含 $HOME/.cargo/bin
• 安装或更新缓慢：
  • 检查是否设置了 RUSTUP_DIST_SERVER 与 RUSTUP_UPDATE_ROOT，以及 $HOME/.cargo/config.toml 是否配置了镜像源。