Ubuntu Rust 工具链如何选择

Ubuntu 上选择 Rust 工具链的建议

一 版本类型与适用场景

• 稳定版 Stable：特性冻结、向后兼容、文档完备，适合新手、生产环境与大多数项目。
• 测试版 Beta：包含即将进入稳定版的功能，风险低于 Nightly，适合希望提前体验新特性且能接受少量问题的用户。
• 开发版 Nightly：包含实验性特性与频繁变更，适合进阶开发者、尝试未稳定 API 或参与生态贡献的场景。
• 版本选择的核心原则：在满足功能需求的前提下，优先选择稳定版；需要新特性时再按需切换到 Beta/Nightly，并尽量限定在项目级而非全局。

二 安装与切换工具链

• 使用 rustup（官方推荐）管理工具链，步骤简洁：
  1. 安装依赖：sudo apt update && sudo apt install -y curl build-essential
  2. 安装 rustup：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  3. 生效环境：source $HOME/.cargo/env
  4. 验证：rustc --version、cargo --version
• 常用命令：
  • 安装与切换：rustup install stable|beta|nightly、rustup default stable
  • 项目级覆盖：rustup override set nightly（仅当前项目使用 Nightly）
  • 更新：rustup update
  • 查看：rustup show
• 说明：apt 也能安装（如 sudo apt install rustc cargo），但通常版本较旧且难以多版本共存；如需较新版本，可添加 Rust 官方 APT 源，但灵活度仍不如 rustup。

三 按场景给出选择方案

四 目标平台与交叉编译要点

• 查看与安装目标：
  • 查看：rustup show
  • 安装：rustup target add <target>（如 aarch64-unknown-linux-gnu、armv7-unknown-linux-gnueabihf、x86_64-unknown-linux-musl）
• 常见目标示例：
  • x86_64-unknown-linux-gnu（常见 64 位 Linux）
  • aarch64-unknown-linux-gnu（ARM64，如树莓派 4/5 64 位）
  • armv7-unknown-linux-gnueabihf（ARM32，如树莓派 3）
  • x86_64-unknown-linux-musl（静态链接 Linux 二进制）
• 交叉编译链接器示例（以 x86_64-pc-windows-gnu 为例）：
  • 安装目标：rustup target add x86_64-pc-windows-gnu
  • 指定链接器：export CARGO_TARGET_X86_64_PC_WINDOWS_GNU_LINKER=x86_64-w64-mingw32-gcc
• 提示：为不同目标分别维护工具链与链接器配置，能显著降低依赖与环境差异带来的构建问题。

五 常见问题与实用建议

• 编译报错 linker ‘cc’ not found：安装构建工具链 sudo apt install build-essential。
• 国内下载慢：设置 rustup 镜像后再安装
  • 示例：export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
  • 示例：export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
• 保持工具链最新：rustup update；检查更新：rustup check。
• 需要离线文档：rustup doc / rustup doc --book / rustup doc --std。
• 服务器运行建议：使用 systemd 管理进程，构建用 –release，必要时开启 RUST_BACKTRACE 便于排错。