Ubuntu 安装 Rust 的推荐方式
在 Ubuntu 上安装 Rust 最推荐的方式是使用 rustup 工具链管理器,它能方便地安装、切换和管理多个 Rust 版本 及组件(如 cargo、clippy、rustfmt)。以下步骤适用于 Ubuntu 20.04/22.04/24.04 等版本。
安装步骤
1)安装依赖
更新索引并安装构建工具,确保后续编译正常:
sudo apt update && sudo apt install -y curl build-essential gcc make
2)下载并运行 rustup 安装脚本
使用官方脚本安装(按提示选择默认配置即可):
curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
3)激活环境变量
安装完成后执行以下命令,或重新打开终端:
source “$HOME/.cargo/env”
4)验证安装
检查工具链版本:
rustc -Vv
cargo -V
看到类似 “rustc 1.xx.x” 与 “cargo 1.xx.x” 即表示安装成功。
国内网络加速
方式一:临时设置镜像环境变量(安装前执行)
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 包索引镜像(安装后配置)
在用户目录下创建或编辑文件:~/.cargo/config.toml(若文件不存在可直接新建),加入:
[registries.crates-io]
index = “https://mirrors.tuna.tsinghua.edu.cn/crates.io-index”
保存后使用 cargo 拉取依赖时会走镜像源,显著提升下载速度。
创建项目与常用命令
使用 Cargo 创建并运行项目
cargo new hello-world
cd hello-world
cargo build # 构建
cargo test # 运行单元测试
cargo run # 构建并运行
常用维护命令
rustup update # 更新工具链与组件
rustup toolchain list # 查看已安装工具链
rustup default nightly # 切换默认工具链为 nightly(示例)
rustup component add clippy rustfmt # 安装常用组件
系统包管理器安装方式(可选)
仅安装基础编译器(版本通常较旧,适合系统级统一管控):
sudo apt update
sudo apt install -y rustc cargo
卸载:
sudo apt remove -y rustc cargo
sudo apt autoremove -y
如需最新特性与多版本管理,仍建议使用 rustup。
常见问题与排查
编译时报错 “linker ‘cc’ not found”
缺少 GNU 编译工具链,安装:sudo apt install -y build-essential
安装或更新缓慢
确认已设置 RUSTUP_DIST_SERVER / RUSTUP_UPDATE_ROOT 环境变量,或在 ~/.cargo/config.toml 中配置了 crates.io 镜像。