Ubuntu Rust开发环境怎么搭建

Ubuntu Rust 开发环境搭建指南

一 安装方式与选择

• 推荐使用 rustup 安装，能获取最新的 稳定版/测试版/夜间版 工具链，并可在项目间灵活切换，同时集成 Cargo、rustc、Clippy、rustfmt 等组件。
• 若仅需在系统层面使用且对版本要求不高，可通过 APT 安装，但版本通常较旧（例如在 Ubuntu 22.04 上 APT 仓库的 Rust v1.61 可能滞后于官方最新稳定版）。
• 建议准备编译依赖：curl、build-essential、gcc、make，以避免后续链接器缺失等问题。

二 使用 rustup 安装与初始化

• 安装依赖并拉取安装脚本（非 root 用户执行，安装仅作用于当前用户）：
  sudo apt update && sudo apt install -y curl build-essential gcc make
  curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
• 按提示选择默认安装（稳定版 + 默认组件），完成后加载环境变量：
  source “$HOME/.cargo/env”
• 验证安装：
  rustc -Vv
  cargo -V
  which rustc && which cargo
• 常用管理命令：
  rustup update（更新工具链）
  rustup toolchain list（查看已安装工具链）
  rustup default nightly（切换默认工具链，按需选择）
  rustup show（查看当前配置）
• 卸载（如需）：rm -rf ~/.cargo ~/.rustup。

三 中国大陆加速与镜像配置

• rustup 安装阶段镜像（在运行安装脚本前设置环境变量）：
  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”
• 说明：镜像能显著提升在国内的下载速度，若某镜像不稳定可切换其他可用镜像。

四 第一个项目与常用工作流

• 使用 Cargo 创建并运行项目：
  cargo new hello-world && cd hello-world
  cargo build（构建）
  cargo test（运行单元测试）
  cargo run（构建并运行）
  cargo build --release（发布构建）
• 直接使用 rustc 的最小示例：
  echo ‘fn main(){println!(“Hello, Rust!”);}’ > main.rs
  rustc main.rs && ./main
• 常用工程化工具（通过 rustup 安装/启用）：rustfmt（格式化）、Clippy（静态检查）、rust-analyzer（语言服务器，配合 VS Code 使用）。

五 常见问题与排查

• 编译时报错 linker ‘cc’ not found：安装编译工具链 build-essential/gcc 即可。
• APT 安装版本过旧：优先使用 rustup 获取最新稳定版。
• 安装或更新缓慢：配置 rustup 与 Cargo 的国内镜像源。
• 权限与环境问题：rustup 默认安装到用户目录，避免用 sudo 执行 rustup/Cargo；若 PATH 未生效，执行 source “$HOME/.cargo/env” 或重启终端。