Ubuntu Rust编译器怎么设置

Ubuntu 上设置 Rust 编译器的推荐做法

一 安装与初始化

想在 Ubuntu 上顺畅地开启 Rust 开发之旅？第一步，先把环境搭建好。这里有两个主流方案，各有侧重。

安装依赖工具：这是基础中的基础，主要是为了后续能顺利编译本地依赖和进行项目构建。打开终端，执行这条命令即可：

sudo apt update && sudo apt install -y curl build-essential gcc make

使用 rustup 安装最新稳定版工具链：这是目前最推荐的方式。rustup 是一个强大的工具链管理器，能让你轻松切换 Rust 版本，管理不同组件。安装只需一条命令：

curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装脚本运行完毕后，别忘记执行 source $HOME/.cargo/env 来让环境变量生效。之后，可以用 rustc -V 和 cargo -V 来验证安装是否成功。

国内下载加速（可选）：如果你觉得从官方源下载速度不够理想，可以在运行上述安装脚本前，先设置这两个环境变量，切换到国内镜像源：

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。通过 sudo apt install -y rustc cargo 就能安装。不过要注意，这种方式安装的版本通常不是最新的，适合那些只需要基础功能、对版本不敏感的场景。安装后，可以用 rustc -Vv 和 which rustc 来查看详情和路径。

二 配置 Cargo 与国内源

环境装好了，下一步是优化体验，核心就是配置 Cargo 的包管理镜像。这能极大提升后续下载项目依赖的速度。

配置 crates.io 镜像：推荐将镜像配置写入用户级的配置文件。首先创建配置目录：

mkdir -p $HOME/.cargo

然后，将以下 TOML 格式的内容写入 $HOME/.cargo/config.toml 文件中：

[registries.crates-io]
index = “https://mirrors.tuna.tsinghua.edu.cn/crates.io-index”

说明：上面是较新的 TOML 格式配置。如果你遇到的是旧版的 $HOME/.cargo/config 文件（INI 风格），可以使用下面的配置：

[source.crates-io]
registry = “https://github.com/rust-lang/crates.io-index”
replace-with = ‘ustc’

[source.ustc]
registry = “git://mirrors.ustc.edu.cn/crates.io-index”

三 常用工具与交叉编译设置

基础环境搞定后，可以再安装一些提升开发效率的工具，并为特定场景（如嵌入式开发）做好准备。

更新与组件管理：

• 更新工具链：rustup update
• 安装常用组件：比如代码格式化工具 rustup component add rustfmt，静态检查工具 rustup component add clippy，以及 rustup component add llvm-tools-preview。
• 二进制工具集：安装 cargo install cargo-binutils，它会提供 objdump、nm、size 等常用二进制分析工具。

交叉编译示例：Rust 的交叉编译能力非常强大。首先可以查看所有支持的目标平台：rustup target list。例如，要为 RISC-V 嵌入式平台添加编译支持，可以执行：rustup target add riscv32imac-unknown-none-elf。

主机工具链依赖：有些项目在构建时可能需要链接特定的系统库。一个常见的预备工作是安装：sudo apt install -y pkg-config libssl-dev，这可以避免很多潜在的链接错误。

四 快速验证与第一个程序

理论说了这么多，是时候跑通第一个程序了。这里有两种最直接的方式。

使用 rustc 直接编译运行：适合快速测试单文件。在终端里依次执行：

echo ‘fn main(){println!(“Hello, Rust on Ubuntu”);}’ > main.rs
rustc main.rs && ./main

看到终端打印出 “Hello, Rust on Ubuntu”，就说明最基本的编译和运行链路通了。

使用 Cargo 管理项目：这才是日常开发的正确打开方式。Cargo 是 Rust 的官方构建系统和包管理器。创建一个新项目并运行：

cargo new hello_cargo && cd hello_cargo
cargo run

这条命令会完成编译并直接运行。如果是需要发布优化版本，则使用 cargo build --release。生成的可执行文件分别位于 target/debug/ 或 target/release/ 目录下。

五 常见问题与排查

最后，汇总几个新手常会遇到的问题，方便快速定位解决。

• 报错 linker ‘cc’ not found：
  原因：系统缺少基础的 C 语言编译工具链。
  解决：安装 build-essential 包：sudo apt install -y build-essential。
• 安装或更新缓慢：
  请检查是否按照前面的步骤正确设置了 RUSTUP_DIST_SERVER 和 RUSTUP_UPDATE_ROOT 环境变量，或者是否配置了 Cargo 的国内镜像源。
• 版本过旧（APT 安装场景）：
  如果通过 apt 安装的 Rust 版本太老，建议卸载后改用 rustup 安装。后者在版本管理和组件添加方面灵活得多，是社区公认的首选工具。