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安装。后者在版本管理和组件添加方面灵活得多，是社区公认的首选工具。
