如何在 Ubuntu 上配置 Rust

在 Ubuntu 上配置 Rust 的完整步骤

一 安装前准备

万事开头先打基础。在正式安装 Rust 之前，我们需要确保系统环境已经就绪。具体来说，就是更新软件源并安装一套基础的编译工具链。这步操作看似简单，却能避免后续编译本地依赖或项目时，出现诸如“linker ‘cc’ not found”这类令人头疼的错误。

• 执行以下命令即可完成准备工作：
  • sudo apt update && sudo apt install -y curl build-essential gcc make

这些工具将为 Cargo 的构建流程以及常见的本地库链接提供必要的支持。

二 安装与初始化 Rust 工具链（推荐 rustup）

接下来进入核心环节。目前，Rust 官方首推的管理工具是 rustup。它的优势在于能让你轻松管理多个工具链版本，无论是稳定版、测试版还是夜间版，切换起来都游刃有余。

• 安装过程非常简单，一条命令搞定：
  • curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装脚本执行完毕后，别忘了加载环境变量。你可以执行 source $HOME/.cargo/env，或者直接重启终端窗口。

怎么验证安装成功了呢？很简单，在终端里敲入下面两个命令看看版本号：

• rustc --version
• cargo --version

如果看到类似 rustc 1.86.0、cargo 1.86.0 的输出（具体版本号会随时间更新），那就恭喜你，工具链已经准备就绪了。

话说回来，rustup 的妙处远不止安装。它更是一个强大的管理工具，下面这几个命令你会经常用到：

• 更新整个工具链：rustup update
• 安装其他版本，比如夜间版：rustup toolchain install nightly
• 切换默认工具链：rustup default nightly
• 按需添加实用组件，例如代码格式化工具和代码检查器：rustup component add rustfmt clippy

三 国内网络加速（可选）

对于国内开发者来说，网络环境有时是个小挑战。不过别担心，我们有成熟的加速方案。这里提供两种主流方式，你可以根据实际情况选择。

方式一：加速 rustup 自身下载。
这个方法是在运行安装脚本前，先设置两个环境变量，将下载源指向国内镜像。

• 在终端中依次执行：
  • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
  • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

设置完成后，再执行之前的 rustup 安装命令，速度会有显著提升。

方式二：配置 Cargo 镜像，加速 crate 包下载。
安装完成后，日常开发中下载依赖库（crate）的速度更为关键。这时需要编辑 Cargo 的配置文件。

• 创建或编辑文件：~/.cargo/config.toml
• 以配置中科大源为例，内容如下：
  • [source.crates-io]
    • registry = “https://github.com/rust-lang/crates.io-index”
    • replace-with = ‘ustc’
  • [source.ustc]
    • registry = “git://mirrors.ustc.edu.cn/crates.io-index”
• 也可以使用清华源，配置示例略有不同：
  • [registries]
    • crates-io = { index = “https://mirrors.tuna.tsinghua.edu.cn/crates.io-index” }

需要警惕的是，镜像地址偶尔可能变更或暂时不可用。如果遇到下载问题，请检查网络连接或尝试更换其他可用镜像，并务必确认配置文件中的每一项都书写正确。

四 创建项目与常用命令

环境配置妥当，是时候动手写点代码了。Rust 的官方构建工具 Cargo 极大地简化了项目管理流程。

你可以用它快速创建一个新项目：

• 新建一个二进制项目：cargo new hello_world
• 进入项目目录：cd hello_world
• 构建项目：cargo build
• 直接运行项目：cargo run

执行 cargo run 时，Cargo 会自动完成编译并运行生成的可执行文件，屏幕上会打印出经典的 “Hello, world!”。

当然，对于单个 Rust 文件，你也可以选择更直接的方式，使用 rustc 编译器：

• 示例：rustc main.rs && ./main

五 系统级安装与卸载（备选）

除了官方推荐的 rustup，Ubuntu 的 APT 仓库也提供了 Rust 包。但这通常作为备选方案，原因在于其版本往往不是最新的。

• 安装命令：sudo apt install -y rustc cargo
• 卸载命令：sudo apt remove --auto-remove rustc cargo

那么，该如何选择呢？经验表明，对于大多数开发场景，rustup 是更优的选择。它提供了版本切换的灵活性和丰富的组件管理功能。而通过 APT 进行系统级安装，则更适合那些对 Rust 版本要求不高，或者需要由系统统一进行软件管控的环境。