目录

  1. 什么是 Rust 环境搭建
  2. 为什么要搭建 Rust 环境
  3. 系统要求
  4. 安装 Rust
  5. 验证安装
  6. 配置开发工具
  7. 更新与卸载
  8. 常见问题与解决
  9. 参考资料与出站链接

什么是 Rust 环境搭建

Rust 环境搭建是指在您的计算机上安装 Rust 编译器 (rustc)、包管理器 (cargo) 和相关工具（如 rustup），以便编写、编译和运行 Rust 代码。

为什么要搭建 Rust 环境

  • 开发准备：运行 Rust 程序需要编译器和工具链。
  • 项目管理：Cargo 提供依赖管理和构建支持。
  • 版本控制：rustup 便于切换和更新 Rust 版本。
  • 生态集成：支持社区库和工具的使用。

系统要求

  • 操作系统：
  • Linux（大多数发行版，如 Ubuntu、Fedora）
  • macOS（10.13 或更高）
  • Windows（10 或 11，推荐 WSL2）
  • 硬件：至少 2GB 内存，5GB 磁盘空间。
  • 依赖：
  • Linux/macOS：需要 gcc 或 clang（用于链接）。
  • Windows：需要 Visual Studio Build Tools 或 MinGW。

安装 Rust

Rust 官方推荐使用 rustup 安装工具，它会同时安装 rustc、cargo 和其他组件。

Linux 和 macOS

  1. 运行安装脚本：
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  1. 按照提示操作：
  • 选择 1) Proceed with installation (default)。
  • 安装完成后，脚本会自动配置环境变量。
  1. 生效环境变量：
   source $HOME/.cargo/env

Windows

  1. 下载安装程序：
  • 访问 rustup.rs，下载 rustup-init.exe。
  1. 运行安装：
  • 双击 rustup-init.exe，按提示选择默认安装。
  • 需要安装 Visual Studio Build Tools（C++ 构建工具）。
  1. 环境变量：
  • 安装程序会自动将 ~/.cargo/bin 添加到 PATH。

手动安装（可选）

  • 如果不使用 rustup，可以从 Rust 官网 下载独立安装包，但不推荐，因为更新和管理不便。

验证安装

  1. 检查版本：
   rustc --version
   cargo --version
   rustup --version

示例输出：

   rustc 1.77.0 (a5d1d7a33 2024-03-11)
   cargo 1.77.0 (e52e36006 2024-03-11)
   rustup 1.27.0 (2024-03-11)
  1. 运行简单程序：
  • 创建文件 hello.rs：
   fn main() {
       println!("Hello, Rust!");
   }
  • 编译并运行：
   rustc hello.rs
   ./hello  # Windows 下为 hello.exe

输出：

   Hello, Rust!

配置开发工具

  1. 推荐 IDE：
  • VS Code：
    • 安装插件：rust-analyzer（语法检查和自动完成）。
    • 下载：https://code.visualstudio.com/
  • IntelliJ Rust（JetBrains）：适用于 IntelliJ IDEA。
  1. 命令行工具：
  • cargo fmt：代码格式化（需安装 rustfmt）。
  • cargo clippy：代码检查（需安装 clippy）。
   rustup component add rustfmt clippy
  1. Rust 工具链：
  • 切换版本：
   rustup install 1.76.0
   rustup default 1.76.0

更新与卸载

  • 更新 Rust：
  rustup update
  • 卸载 Rust：
  rustup self uninstall
  • 这会移除 rustup、rustc 和 cargo，但不会删除项目文件。

常见问题与解决

  1. 安装脚本下载失败：
  • 检查网络连接，或手动下载 rustup-init。
  1. 环境变量未生效：
  • Linux/macOS：重启终端或手动 source ~/.cargo/env。
  • Windows：重启命令提示符。
  1. 依赖缺失：
  • Linux：安装 build-essential（Ubuntu）或 gcc（其他）。
  • Windows：安装 Visual Studio Build Tools。
  1. 权限问题：
  • 使用 --no-modify-path 参数安装到自定义目录：
   curl ... | sh -s -- --no-modify-path

参考资料与出站链接

  1. 官方文档：
  1. 学习资源：
  1. 工具与支持：