Ubuntu系统安装Rust开发环境详细教程
作者：技术拾光时间：2026-05-19 18:59:07浏览：519
在 Ubuntu 上配置 Rust 环境 一 安装前准备 万事开头先打基础。在正式安装Rust之前，有几个简单的准备工作需要完成，这能确保后续过程一路绿灯。 更新索引并安装基础编译工具：这一步是为了确保系统能顺利编译本地依赖和构建项目。打开终端，执行这条命令即可： sudo apt update &
在 Ubuntu 上配置 Rust 环境
一 安装前准备
万事开头先打基础。在正式安装Rust之前，有几个简单的准备工作需要完成，这能确保后续过程一路绿灯。
- 更新索引并安装基础编译工具：这一步是为了确保系统能顺利编译本地依赖和构建项目。打开终端，执行这条命令即可：
sudo apt update && sudo apt install -y curl build-essential gcc make
- 用户权限建议：强烈建议使用非 root 用户进行安装和日常开发。这样做的好处是能避免对系统范围产生不必要的影响，操作也更安全。
二 安装与激活 Rust 工具链
准备好了？接下来就是核心环节。目前，最主流且推荐的方式是使用 rustup 工具链管理器。
- 使用 rustup 安装（推荐）：这种方式便于后续的多版本管理和更新，是社区的首选。
- 安装命令：直接运行这条命令开始安装：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - 安装配置：安装过程中，通常会提示你选择配置。对于大多数用户来说，直接选择默认配置（安装稳定版 Stable 及其包管理器 Cargo）就是最佳选择。
- 激活环境：安装完成后，需要激活环境变量。执行
source "$HOME/.cargo/env"，或者更简单——直接关闭并重新打开终端。 - 验证安装：怎么确认一切就绪呢？用这两个命令检查一下：
rustc -Vv：查看 Rust 编译器的详细版本信息。cargo -V：查看 Cargo 包管理器的版本。
- 安装命令：直接运行这条命令开始安装：
- 备选方式（系统包管理器安装）：如果你追求极致的系统统一管理，也可以使用 Ubuntu 自带的包管理器。
- 命令：
sudo apt install -y rustc cargo - 特点：这种方式安装的版本通常不是最新的，但胜在能与系统其他包统一管理，适合对版本要求不高的简单使用场景。
- 命令：
三 国内镜像加速（可选）
身处国内网络环境？别担心，通过配置镜像可以极大提升下载速度，节省宝贵时间。这一步是可选的，但强烈建议进行配置。
- 加速工具链安装（rustup）：在运行上述安装脚本之前，先设置这两个环境变量：
export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-staticexport RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
curl ... | sh命令开始安装，速度会有显著提升。 - 加速依赖下载（Cargo 索引与包）：安装完成后，日常开发中拉取依赖库也需要加速。这需要通过修改 Cargo 的配置文件来实现。
- 在用户目录下创建或编辑配置文件：
~/.cargo/config.toml - 以使用清华大学镜像为例，在文件中添加以下内容：
[registries] crates-io = { index = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index" } - 重要提示：镜像地址可能会随时间调整。如果配置后速度依然不理想或出现错误，可以搜索并更换为当前可用的其他国内镜像地址。
- 在用户目录下创建或编辑配置文件：
四 创建项目与常用操作
环境配置妥当，是时候开始你的第一个 Rust 项目了。Cargo 是 Rust 的项目管理和构建工具，绝大多数操作都围绕它展开。
- 使用 Cargo 管理项目：
- 新建一个二进制项目：
cargo new hello_world && cd hello_world - 构建项目：
cargo build - 运行项目：
cargo run - 直接编译单文件（适用于简单测试）：
rustc main.rs && ./main
- 新建一个二进制项目：
- 常用维护命令：
- 更新工具链：
rustup update - 切换工具链版本（例如尝试 nightly 版本）：
rustup install nightly && rustup default nightly - 卸载 Rust（仅针对 rustup 安装方式）：
rustup self uninstall
- 更新工具链：
五 常见问题与排查
最后，分享几个新手可能会踩到的小坑以及解决方法，让你在遇到问题时能快速定位。
- 编译报错 linker ‘cc’ not found：
- 原因：系统缺少基础的 GNU C 编译工具链。
- 解决：运行命令安装即可：
sudo apt install -y build-essential
- 安装或更新速度极其缓慢：
- 排查：首先检查是否已经正确设置了
RUSTUP_DIST_SERVER与RUSTUP_UPDATE_ROOT环境变量。其次，确认~/.cargo/config.toml文件中的镜像配置是否正确无误。往往是这里的配置决定了下载的“高速公路”是否畅通。
- 排查：首先检查是否已经正确设置了