Debian如何配置Rust工具链

Debian 配置 Rust 工具链

一 安装方式选择

• 使用官方版本管理器 rustup（推荐）：可轻松切换 stable / beta / nightly，按需安装目标三元组与组件，适合开发与多版本并存。
• 使用 Debian 仓库安装 rustc/cargo：系统级、稳定，但版本通常滞后，适合生产环境或无需频繁升级的场景。

二 使用 rustup 安装与配置（推荐）

• 安装 rustup 并加载环境
  • 执行安装脚本：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 使环境变量生效：source "$HOME/.cargo/env"
• 验证安装：rustc --version、cargo --version
• 选择默认工具链：rustup default stable
• 安装常用组件：rustup component add rustfmt clippy rust-src rust-analysis
• 安装交叉编译目标（示例）：rustup target add armv7-unknown-linux-gnueabihf
• 多用户或集中环境（可选）：安装到 /opt/rust 并写入全局配置
  • 安装：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --no-modify-path -y
  • 配置：echo 'export RUSTUP_HOME=/opt/rust' | sudo tee -a /etc/profile.d/rust.sh 与 echo 'export PATH=$PATH:/opt/rust/bin' | sudo tee -a /etc/profile.d/rust.sh
  • 生效：source /etc/profile
• 常用维护
  • 更新工具链：rustup update
  • 卸载：rustup self uninstall

三 使用 Debian 仓库安装（系统级）

• 安装工具链与构建依赖
  • sudo apt update
  • sudo apt install rustc cargo
  • 建议同时安装构建工具：sudo apt install build-essential gcc make
• 验证：rustc --version、cargo --version
• 说明：版本跟随 Debian 仓库更新，通常较稳定；如需最新特性或 nightly，请改用 rustup。

四 常用配置与最佳实践

• 项目级工具链
  • 在项目根目录创建 .rustup/toolchain 文件并写入如 stable 或 1.75.0，进入目录会自动切换；或在 shell 中设置 export RUSTUP_TOOLCHAIN=stable 作为全局默认。
• Cargo 配置
  • 全局配置文件：~/.cargo/config.toml，可用于设置镜像源、默认目标、构建脚本等。
• 环境变量（按需）
  • 若未自动加入 PATH，可在 ~/.bashrc / ~/.zshrc 中添加：export PATH="$HOME/.cargo/bin:$PATH"，然后 source 相应文件。
• 构建与运行
  • 常规：cargo build、cargo run
  • 发布构建：cargo build --release（产物在 target/release）。