Rust在Ubuntu上如何使用Cargo包管理器

在 Ubuntu 上使用 Cargo 管理 Rust 项目

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

一 安装与准备

要在 Ubuntu 系统上高效地进行 Rust 开发，安装 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"

安装完成后，可以通过以下命令验证 Rust 编译器和 Cargo 是否安装成功：

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

此外，Ubuntu 的官方软件仓库也提供了 Rust 和 Cargo，但版本可能不是最新的。可以通过 apt 包管理器快速安装：

sudo apt install -y rustc cargo

无论选择哪种方法，完成安装后，你的开发环境就已配置好 Rust 工具链和 Cargo 包管理器。

二 配置 Cargo 与镜像

为了优化 Rust 依赖包的下载速度，配置 crates.io 的国内镜像是一个有效的解决方案。

操作非常简单，只需编辑或创建 Cargo 的配置文件 ~/.cargo/config.toml，并添加以下镜像设置：

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

配置完成后，Cargo 在拉取项目依赖时会自动使用该镜像源，显著提升下载效率。

三 常用 Cargo 命令

掌握 Cargo 的核心命令是进行 Rust 项目开发的基础。

创建新项目： 使用 cargo new 命令快速初始化一个 Rust 项目结构。

cargo new hello_world
cd hello_world

构建与运行项目： Cargo 提供了一系列命令来编译、检查和运行你的代码。

cargo build   # 编译项目（默认生成调试版本）
cargo run     # 编译并立即运行项目
cargo check   # 快速检查代码语法和类型，不生成可执行文件（速度更快）
cargo test    # 运行项目中所有的单元测试和集成测试

管理项目依赖： Rust 的依赖管理非常简洁。所有依赖声明都在项目根目录的 Cargo.toml 文件中。只需在 [dependencies] 部分添加所需的库及其版本号即可。例如，添加随机数库：

[dependencies]
rand = "0.8"

保存文件后，执行 cargo build，Cargo 会自动下载并编译指定的依赖项。

四 多版本工具链与更新

Rust 提供了稳定版、测试版和 Nightly 版本。rustup 可以方便地管理多个 Rust 工具链。

rustup update          # 更新所有已安装的工具链和 rustup 自身
rustup toolchain list  # 列出当前系统中安装的所有 Rust 工具链
rustup default stable  # 将稳定版设置为全局默认工具链
rustup override set nightly # 仅为当前目录的项目临时切换到 Nightly 版本

定期使用 rustup update 更新工具链，可以确保你始终使用最新的 Rust 功能和修复。

五 常见问题与卸载

这里汇总了一些在 Ubuntu 上使用 Rust 和 Cargo 时可能遇到的问题及解决方法。

如果在编译时遇到 linker ‘cc’ not found 这类错误，通常是因为缺少 C 语言编译环境。安装 build-essential 包即可解决：

sudo apt install -y build-essential

如果需要卸载 Rust 和 Cargo，请根据当初的安装方式选择对应的方法：

• 通过 rustup 安装： 使用 rustup 自带的卸载命令可以彻底移除。

rustup self uninstall

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

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

安装后若在终端中无法识别 cargo 命令，可能是因为 ~/.cargo/bin 目录未添加到 PATH 环境变量中。执行 source "$HOME/.cargo/env" 或重新启动终端会话即可解决。