Ubuntu系统安装与使用Rust Cargo包管理器教程

在 Ubuntu 上使用 Cargo 管理 Rust 项目

一 安装与准备

想在 Ubuntu 上顺畅地使用 Rust 和 Cargo，首推通过官方的 rustup 工具链管理器来安装。它能帮你获取最新的稳定版本，并一次性搞定 Rust 编译器和 Cargo 包管理器。

首先，确保系统有基础的编译工具，然后下载并运行安装脚本：

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 --version
cargo --version

如果下载速度不理想，特别是在国内网络环境下，可以先设置镜像源再执行安装脚本，速度会快很多：

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

当然，还有一种更直接但可能版本稍旧的方法，就是通过系统包管理器安装：

sudo apt install -y rustc cargo

完成以上任意一种方式，你的用户环境里就已经准备好最新的 Rust 工具链和 Cargo 了。

二 配置 Cargo 与镜像

为了进一步提升依赖包的下载体验，配置一个 crates.io 的索引镜像是非常实用的可选步骤。

操作很简单，编辑或创建文件 ~/.cargo/config.toml，加入以下内容：

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

保存之后，Cargo 在拉取依赖时就会优先使用这个镜像，能有效节省等待时间。

三 常用 Cargo 命令

接下来，看看日常开发中离不开的几个 Cargo 命令。

创建项目： 这是一切的起点。

cargo new hello_world
cd hello_world

构建与运行： 一套组合拳，完成从代码到可执行程序的转变。

cargo build   # 构建项目（默认是 debug 模式）
cargo run     # 构建并直接运行
cargo check   # 快速检查代码能否编译通过（不生成最终文件，速度更快）
cargo test    # 运行项目中的测试用例

依赖管理： Rust 的依赖管理非常清晰。只需要在项目根目录的 Cargo.toml 文件里，找到 [dependencies] 部分，添加你需要的库和版本即可。例如：

[dependencies]
rand = "0.8"

保存文件后，执行一次 cargo build，Cargo 就会自动下载并编译这个依赖，省心省力。

四 多版本工具链与更新

如果你需要同时使用稳定版、测试版或 nightly 版本，rustup 同样能轻松管理。

rustup update          # 更新所有已安装的工具链和组件
rustup toolchain list  # 查看当前安装了哪些工具链
rustup default stable  # 将稳定版设置为全局默认
rustup override set nightly # 仅为当前目录下的项目切换到 nightly 版本

记住，保持工具链更新是个好习惯，而通过 rustup update 来操作，能确保 Rust 编译器和 Cargo 始终保持版本一致，避免意外问题。

五 常见问题与卸载

最后，聊聊可能遇到的小麻烦以及如何彻底清理。

如果编译时遇到类似 linker ‘cc’ not found 的错误，通常是缺少基础的 C 编译工具链，安装一下即可：

sudo apt install -y build-essential

至于卸载，则取决于当初的安装方式：

• 通过 rustup 安装： 一条命令就能干净移除。

rustup self uninstall

通过 apt 安装： 使用包管理器进行卸载。

sudo apt remove -y rustc cargo
sudo apt autoremove -y

还有一个实用小提示：安装后如果发现终端找不到 cargo 命令，很可能是 ~/.cargo/bin 目录没有加入到系统的 PATH 环境变量中。执行一下 source "$HOME/.cargo/env" 或者直接重启终端，通常就能解决问题。