Ubuntu下Rust环境怎样搭建

Ubuntu 下 Rust 环境搭建指南

一 安装前准备

• 更新索引并安装基础编译工具，确保后续工具链与链接器可用：
  • 命令：sudo apt update && sudo apt install -y curl build-essential gcc make
• 说明：build-essential 提供 gcc/make 等工具，解决常见的链接器 cc not found 问题。

二 安装方式

• 推荐方式：使用 rustup（获取最新稳定版与完整工具链，便于多版本管理）
  • 安装命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 激活环境：source "$HOME/.cargo/env"（或新开终端）
  • 验证：rustc --version、cargo --version
  • 更新：rustup update
  • 卸载：rustup self uninstall
• 备选方式：使用系统包管理器 APT（版本通常较旧，适合系统级统一管控）
  • 安装命令：sudo apt install -y rustc cargo
  • 验证：rustc -Vv、cargo -V
  • 卸载：sudo apt remove -y rustc cargo && sudo apt autoremove -y
• 说明：rustup 是官方推荐的工具链管理器，支持多版本与交叉编译；APT 安装便捷但版本可能滞后。

三 国内网络加速

• 方式一：设置 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 安装脚本，可显著提升工具链下载速度。
• 方式二：配置 Cargo 镜像（crates.io 索引与包下载）
  • 编辑文件：$HOME/.cargo/config.toml
  • 示例（中科大源）：
    • [registries] crates-io = { index = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index" }
  • 或（USTC Git 源）：
    • [source.crates-io] replace-with = 'ustc'
    • [source.ustc] registry = "git://mirrors.ustc.edu.cn/crates.io-index"
  • 说明：两种写法二选一，按你的网络与稳定性选择；如使用 Git 源需确保 git 已安装。

四 创建项目与常用命令

• 使用 Cargo 创建并运行项目：
  • 新建：cargo new hello_world && cd hello_world
  • 构建：cargo build
  • 运行：cargo run
  • 测试：cargo test
• 直接使用 rustc 编译单文件：
  • 编译：rustc main.rs
  • 运行：./main
• 说明：Cargo 是 Rust 的构建系统与包管理器，能自动管理依赖与构建流程。

五 常见问题与 IDE 配置

• 常见问题
  • 链接器错误 linker ‘cc’ not found：安装 build-essential（见上文）。
  • 安装或更新缓慢：配置 rustup 与 Cargo 镜像（见上文）。
  • 权限问题：rustup 默认仅影响当前用户，无需 sudo 执行安装与更新。
• VS Code 开发体验
  • 安装 VS Code，并添加扩展：Rust、C/C++、Chinese（Simplified）Language Pack。
  • 可选：安装 rust-analyzer 以获得更好的智能提示与诊断（通过扩展市场或 rustup 组件）。
• 说明：上述插件组合覆盖代码高亮、调试与语言支持，适合入门与日常开发。