如何配置Linux下的Rust工具链

Linux 下 Rust 工具链配置全流程

一 安装与基础配置

• 使用官方推荐的 rustup 安装，无需 root 权限，命令如下：
  • 下载并安装：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 使环境变量生效：source "$HOME/.cargo/env"
  • 验证安装：rustc --version、cargo --version
• 若使用发行版包管理器（如 apt、dnf、yum）也可安装稳定版，但版本通常较旧，且不便在 stable/beta/nightly 间切换，开发更推荐 rustup。

二 使用 rustup 管理工具链

• 查看工具链状态：rustup show（可见默认、已安装与目标三元组）
• 切换或设置默认工具链：
  • 设为稳定版：rustup default stable
  • 使用夜间版：rustup default nightly
  • 为当前项目设置：rustup override set nightly
• 安装指定工具链：rustup toolchain install stable|beta|nightly
• 更新工具链：rustup update
• 检查更新：rustup check
• 查看工具链与工具路径：rustup which rustc、rustup which cargo
• 卸载 Rust（含工具链与配置）：rustup self uninstall

三 国内镜像加速

• 配置安装源与更新源（写入 ~/.bashrc 或 ~/.zshrc 后执行 source 使其生效）：
  • 中科大镜像：
    • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
    • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
  • 清华镜像：
    • export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
    • export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
• 说明：上述变量仅影响 rustup 的下载；若后续 crates.io 拉取依赖较慢，可在用户目录创建 .cargo/config.toml 配置 Cargo 镜像（见下一节）。

四 创建项目与编辑器配置

• 创建并运行项目：
  • 新建二进制项目：cargo new hello && cd hello
  • 运行：cargo run
• 常用 Cargo 子命令：
  • 构建：cargo build
  • 运行测试：cargo test
  • 检查代码：cargo check
  • 更新依赖：cargo update
• VS Code 配置：
  • 安装扩展：rust-analyzer（提供补全、诊断、跳转、重构等）
  • 可选：Rust Syntax、crates、Better TOML、Rust Test Lens 等增强插件
• 本地文档：
  • 打开离线文档：rustup doc
  • 打开《Rust 程序设计语言》：rustup doc --book

五 常见问题与排查

• 命令未找到：确认已执行 source "$HOME/.cargo/env"，或检查 ~/.bashrc/~/.zshrc 是否包含 export PATH="$HOME/.cargo/bin:$PATH" 并重新加载
• 权限问题：rustup 默认安装到用户目录，不需要 sudo；避免使用 sudo cargo 以免污染系统目录
• 版本切换无效：在项目根目录执行 rustup override set nightly，或确认 rustup show 中的当前工具链
• 网络慢或超时：配置 rustup 镜像；如依赖下载慢，再为 crates.io 配置 Cargo 镜像（在 ~/.cargo/config.toml 添加相应 registry 配置）