Ubuntu 系统安装 Rust 开发环境完整指南

一、安装前的准备工作

在 Ubuntu 上安装 Rust 之前，完成以下准备工作能让安装过程更加顺畅，避免常见错误。

• 更新系统并安装编译工具链：这是确保 Rust 及其依赖能够成功编译的关键步骤。打开终端，执行以下命令：
  • sudo apt update && sudo apt install -y curl build-essential gcc make
• 用户权限建议：强烈建议使用普通用户（非 root 用户）进行 Rust 的安装和日常开发工作。这能有效提升系统安全性，防止误操作影响系统核心文件。

二、安装与配置 Rust 工具链

准备工作完成后，即可开始安装 Rust。官方推荐使用 rustup 工具链管理器，它提供了最灵活和便捷的版本管理功能。

• 使用 rustup 安装（官方推荐）：这是管理 Rust 版本和更新的标准方式。
  • 安装命令：在终端中运行以下命令启动安装程序：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 安装配置：安装过程中会提示选择安装选项。对于绝大多数开发者，选择默认选项（安装稳定版及 Cargo）即可满足需求。
  • 激活环境变量：安装完成后，需要加载 Rust 环境变量。执行 source "$HOME/.cargo/env" 或直接重启终端会话。
  • 验证安装结果：通过以下命令检查 Rust 编译器和 Cargo 包管理器是否安装成功：
    • rustc -Vv：显示 Rust 编译器的详细版本和构建信息。
    • cargo -V：显示 Cargo 包管理器的版本号。
• 备选方案：通过 APT 包管理器安装：如果你偏好使用系统包管理器，Ubuntu 仓库也提供了 Rust。
  • 命令：sudo apt install -y rustc cargo
  • 特点：此方法安装的版本可能不是最新的，但能与系统其他软件包统一管理，适合对版本不敏感或追求系统一致性的用户。

三、配置国内镜像加速（提升下载速度）

对于国内用户，配置镜像源可以大幅提升 Rust 工具链和依赖包的下载速度，是提升开发效率的重要步骤。

• 加速 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 拉取 crates.io 索引和包也需要加速。这需要修改 Cargo 的配置文件。
  • 创建或编辑 Cargo 的配置文件：~/.cargo/config.toml
  • 以配置清华大学 TUNA 镜像源为例，在文件中添加以下内容：

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

  • 注意事项：镜像地址可能发生变更。如果配置后速度不佳或出现连接错误，建议查询并更换为当前可用的其他国内镜像源，如上海交大、阿里云等。

四、创建 Rust 项目与常用开发命令

环境配置完成后，即可开始 Rust 编程。Cargo 是 Rust 的核心构建系统和包管理器，所有项目操作都离不开它。

• 使用 Cargo 进行项目管理：
  • 创建新的二进制项目：cargo new hello_world && cd hello_world
  • 编译项目：cargo build
  • 编译并运行项目：cargo run
  • 直接编译单个 Rust 文件（用于快速测试）：rustc main.rs && ./main
• 常用维护与版本管理命令：
  • 更新 Rust 工具链：rustup update
  • 安装并切换到 Nightly 版本：rustup install nightly && rustup default nightly
  • 卸载通过 rustup 安装的 Rust：rustup self uninstall

五、常见问题排查与解决方案

在 Ubuntu 上配置和使用 Rust 时，可能会遇到一些典型问题。以下是快速排查和解决方法。

• 编译错误：linker ‘cc’ not found：
  • 问题原因：系统缺少 C 语言编译链接器，这是构建 Rust 项目的基础依赖。
  • 解决方案：安装 build-essential 包：sudo apt install -y build-essential
• 安装或更新速度非常慢：
  • 排查步骤：首先确认是否已正确设置 RUSTUP_DIST_SERVER 和 RUSTUP_UPDATE_ROOT 环境变量。其次，检查 ~/.cargo/config.toml 文件中的镜像配置是否准确且未过时。正确的镜像配置是解决下载缓慢问题的关键。