Rust 环境搭建

在中文环境下讲解如何在不同操作系统(Windows、macOS、Linux)上搭建 Rust 编程环境。以下是详细步骤,涵盖安装、验证和基本配置,适合初学者和需要快速上手的开发者。


1. Rust 简介

Rust 是一门注重性能、安全和并发性的系统编程语言。搭建 Rust 环境主要通过官方工具 rustup 完成,它可以管理 Rust 版本、工具链和相关组件。


2. 安装 Rust(使用 rustup)

Rust 官方推荐使用 rustup 来安装和管理 Rust 环境。以下是各平台的安装步骤:

2.1 Windows

  1. 下载 rustup
  1. 运行安装程序
  • 双击 rustup-init.exe,按照提示进行安装。
  • 默认选项会安装最新稳定版 Rust,并配置环境变量。
  • 选择 1) Proceed with installation (default) 并回车。
  1. 安装依赖(Windows 特定)
  • 如果计划使用 Rust 进行本地开发,建议安装 Microsoft C++ Build Tools
  • 或者安装 Visual Studio Community 版,确保包含 C++ 开发工具。
  1. 验证安装
  • 打开命令提示符(cmd)或 PowerShell,输入:
    bash rustc --version cargo --version
  • 应输出类似:
    rustc 1.81.0 (2024-09-12) cargo 1.81.0 (2024-09-12)

2.2 macOS

  1. 安装 rustup
  • 打开终端,运行以下命令:
    bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 按提示选择默认安装(输入 1 并回车)。
  • 安装完成后,rustup 会自动配置环境变量。
  1. 配置环境变量
  • 如果终端提示需要更新环境变量,运行:
    bash source $HOME/.cargo/env
  • 或者重启终端。
  1. 验证安装
  • 在终端输入:
    bash rustc --version cargo --version
  • 确认版本信息输出正确。

2.3 Linux

  1. 安装 rustup
  • 打开终端,运行:
    bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 选择默认安装(输入 1 并回车)。
  1. 安装依赖
  • 大多数 Linux 发行版需要安装 C 编译器和相关工具。例如,在 Ubuntu/Debian 上:
    bash sudo apt update sudo apt install build-essential
  • 在 Fedora 上:
    bash sudo dnf groupinstall "Development Tools"
  1. 配置环境变量
  • 运行:
    bash source $HOME/.cargo/env
  • 或者将以下内容添加到 ~/.bashrc~/.zshrc
    bash export PATH="$HOME/.cargo/bin:$PATH"
  1. 验证安装
  • 输入:
    bash rustc --version cargo --version
  • 确认版本信息。

3. 基本工具说明

安装 Rust 后,你会得到以下核心工具:

  • rustc:Rust 编译器,用于编译 Rust 代码。
  • cargo:Rust 的构建工具和包管理器,用于管理项目、依赖和构建。
  • rustup:Rust 工具链管理器,用于更新 Rust、切换版本或安装其他工具链。

4. 创建和运行第一个 Rust 项目

  1. 创建新项目
  • 在终端运行:
    bash cargo new hello_rust cd hello_rust
  • 这会生成一个新目录 hello_rust,包含:
    • Cargo.toml:项目配置文件。
    • src/main.rs:主程序文件。
  1. 编写代码
  • 打开 src/main.rs,默认内容为:
    rust fn main() { println!("Hello, world!"); }
  • 你可以直接运行或修改代码。
  1. 构建和运行
  • 编译并运行项目:
    bash cargo run
  • 输出:
    Hello, world!
  • 或者单独编译:
    bash cargo build
  • 运行编译后的可执行文件(在 target/debug/ 目录下):
    bash ./target/debug/hello_rust # Linux/macOS .\target\debug\hello_rust.exe # Windows

5. 配置开发环境

为了提高开发效率,建议配置以下工具:

5.1 代码编辑器

  • VS Code(推荐):
  • 安装 Visual Studio Code:https://code.visualstudio.com/
  • 安装 Rust 插件:
    • rust-analyzer:提供代码补全、语法检查、跳转等功能。
      bash code --install-extension rust-lang.rust-analyzer
    • CodeLLDB(可选):用于调试。
  • 配置完成后,VS Code 会自动识别 Rust 项目并提供智能提示。
  • 其他编辑器
  • IntelliJ IDEA(安装 Rust 插件)。
  • Neovim 或 Vim(搭配 rust-analyzer 和 LSP 插件)。
  • CLion(支持 Rust,但需要付费)。

5.2 调试工具

  • Linux/macOS:安装 gdblldb
  • Ubuntu/Debian:
    bash sudo apt install gdb
  • macOS(lldb 通常已内置)。
  • Windows:使用 Visual Studio 的调试器或安装 lldb
  • 在 VS Code 中,使用 CodeLLDB 插件进行调试。

5.3 格式化和检查

  • 格式化代码:
  cargo fmt
  • 需要安装 rustfmt(默认随 rustup 安装)。
  • 静态检查:
  cargo clippy
  • 需要安装 clippy
    bash rustup component add clippy

6. 管理 Rust 版本

rustup 允许你管理多个 Rust 版本:

  • 更新 Rust
  rustup update
  • 安装特定版本
  rustup install 1.80.0
  • 切换默认版本
  rustup default 1.80.0
  • 查看已安装版本
  rustup show

7. 注意事项

  1. 网络问题
  • 如果在中国大陆访问 rustup.rs 较慢,可使用镜像:
    • 设置环境变量(Linux/macOS):
      bash export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
    • 然后再运行 curl 命令安装。
  • Windows 用户可手动下载 rustup-init.exe 或使用镜像站(如 https://mirrors.tuna.tsinghua.edu.cn/rustup)。
  1. 依赖安装
  • 确保 C 编译器和相关工具已安装,否则某些依赖可能无法编译。
  • Windows 用户必须安装 Microsoft C++ Build Tools。
  1. Cargo 配置
  • 可编辑 ~/.cargo/config.toml 添加国内镜像加速依赖下载: [source.crates-io] replace-with = 'ustc'

[source.ustc]

registry = “https://mirrors.ustc.edu.cn/crates.io-index”

  1. 常见问题
  • 如果 rustccargo 命令不可用,检查环境变量是否包含 $HOME/.cargo/bin(Linux/macOS)或 %USERPROFILE%\.cargo\bin(Windows)。
  • 如果编译慢,检查网络连接或使用镜像。

8. 总结

搭建 Rust 环境的核心步骤是:

  1. 使用 rustup 安装 Rust 工具链(rustccargo 等)。
  2. 配置环境变量,确保命令可用。
  3. 安装 C 编译器和相关依赖(Windows 需要额外安装 C++ Build Tools)。
  4. 配置编辑器(如 VS Code + rust-analyzer)提高开发效率。
  5. 使用 cargo 创建、构建和运行项目。

完成以上步骤后,你即可开始编写和运行 Rust 程序。如果需要更详细的配置说明、特定平台的帮助,或其他 Rust 相关问题,请告诉我!

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注