Ubuntu Rust环境搭建教程

Ubuntu系统搭建Rust环境的详细步骤

1. 准备工作：更新系统依赖

在安装Rust前，需确保系统包列表和依赖库为最新状态，避免后续安装冲突。执行以下命令：

sudo apt update && sudo apt upgrade -y

此命令会同步Ubuntu软件仓库的最新版本，并升级已安装的包。

2. 安装Rust工具链（推荐使用rustup）

Rust官方推荐通过rustup工具管理Rust版本（支持多版本切换、工具链更新）。rustup会安装Rust编译器（rustc）、包管理器（Cargo）及常用工具（如clippy、rustfmt）。

• 下载并运行安装脚本：执行以下命令下载并运行rustup安装脚本（国内用户可使用中科大或清华镜像加速）：

  # 使用中科大镜像（推荐）export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-staticexport RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustupcurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

  脚本会提示选择安装类型，直接按回车键选择默认选项（安装稳定版Rust+Cargo）。

• 激活环境：安装完成后，需将Rust工具链添加到系统PATH环境变量。执行以下命令使更改立即生效：

  source $HOME/.cargo/env

  或将上述命令添加到~/.bashrc文件（永久生效）。

3. 验证Rust安装

通过以下命令检查rustc（Rust编译器）和Cargo（包管理器）的版本，确认安装成功：

rustc --version# 显示Rust编译器版本（如rustc 1.75.0）cargo --version# 显示Cargo包管理器版本（如cargo 1.75.0）

若输出版本号，则说明安装成功。

4. （可选）更新Rust版本

Rust社区定期发布新版本（修复bug、优化性能），可通过rustup快速更新：

rustup update

此命令会自动下载并安装最新稳定版Rust。

5. （可选）安装额外工具

根据开发需求，可安装常用Rust工具增强开发体验：

• Clippy：Rust静态分析工具（检查代码潜在错误）：

  rustup component add clippy

• Rustfmt：Rust代码格式化工具（统一代码风格）：

  rustup component add rustfmt

• 标准库文档：离线查看Rust标准库文档：

  rustup component add rust-docs

  文档默认存储在~/.rustup/toolchains/stable-x86_64-unknown-linux-gnu/share/doc/rust/html目录。

6. 创建并运行第一个Rust项目

通过Cargo快速创建并运行Rust项目，验证环境配置：

• 创建项目：执行以下命令生成名为hello_world的新项目（Cargo会自动创建项目目录及结构）：

  cargo new hello_worldcd hello_world

  项目目录结构如下：

  hello_world/├── Cargo.toml# 项目配置文件（依赖、元数据）└── src/└── main.rs # 主程序入口（默认包含"Hello, world!"示例）

• 编译并运行：在项目目录下执行cargo run，Cargo会自动编译并运行程序：

  cargo run

  若输出Hello, world!n，则说明Rust环境配置正确。

常见问题解决

• 编译错误：linker 'cc' not found：原因是缺少GNU编译器工具链（gcc、make等），执行以下命令安装：

  sudo apt install build-essential

  安装完成后重新编译即可。

• 镜像源失效：若使用国内镜像安装时出现下载失败，需检查RUSTUP_DIST_SERVER和RUSTUP_UPDATE_ROOT环境变量是否设置正确（参考步骤2）。

通过以上步骤，即可在Ubuntu系统上完成Rust环境的搭建，并开始编写Rust程序。