Skip to content

安装与配置

> 完成 Rust 工具链安装,配置 VSCode 开发环境,验证环境正常运行。

安装 Rust

macOS / Linux 安装

bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装完成后执行:

bash
source "$HOME/.cargo/env"

Windows 安装

  1. 访问 https://rustup.rs
  2. 下载 rustup-init.exe
  3. 双击运行,按提示安装

> 注意: Windows 需先安装 Visual Studio Build Tools,选择 "C++ build tools"。

验证安装

bash
rustc --version
cargo --version
rustup --version

预期输出:

rustc 1.85.0 (4d91de4e4 2025-01-15)
cargo 1.85.0 (d73d2cab9 2025-01-14)
rustup 1.27.1 (54dd3d00f 2024-04-24)

工具链详解

rustup - 工具链管理器

概念名称: rustup 是 Rust 的官方工具链管理器,用于安装、更新和切换 Rust 版本。

语法结构:
┌──────────────────────────────────────┐
│  rustup <命令> [参数]                 │
│         ↑     ↑                       │
│         命令  可选参数                │
│                                       │
│  rustup show     → 查看已安装版本     │
│  rustup update   → 更新到最新         │
│  rustup default  → 设置默认版本       │
└──────────────────────────────────────┘

为什么用它?

bash
# 没有 rustup:手动安装,版本固定
curl https://static.rust-lang.org/rustup.sh | sh  # 旧方式,已废弃

# 有 rustup:版本管理、组件添加、多工具链切换
rustup default stable        # 使用稳定版
rustup default nightly       # 切换到每夜版
rustup target add wasm32-unknown-unknown  # 添加 WASM 目标
bash
rustup show              # 查看已安装工具链
rustup update            # 更新到最新版本
rustup default 1.85.0    # 切换版本
rustup component add rustfmt  # 添加格式化工具
rustup component add clippy   # 添加代码检查

cargo - 包管理器

概念名称: cargo 是 Rust 的构建系统和包管理器,负责编译、依赖管理、测试和发布。

语法结构:
┌──────────────────────────────────────┐
│  cargo <命令> [参数]                  │
│        ↑     ↑                        │
│        命令  可选参数                 │
│                                       │
│  cargo new    → 创建项目              │
│  cargo build  → 编译                  │
│  cargo run    → 编译并运行            │
│  cargo test   → 运行测试              │
└──────────────────────────────────────┘

为什么用它?

bash
# 没有 cargo:手动管理依赖、编译参数
rustc main.rs -o main -L deps/  # 手动编译,繁琐易错

# 有 cargo:一键完成所有操作
cargo new my_project  # 创建项目,自动生成 Cargo.toml 和 main.rs
cargo run             # 自动下载依赖、编译、运行
bash
cargo new my_project     # 创建项目
cargo build              # 构建
cargo run                # 运行
cargo test               # 测试
cargo fmt                # 格式化
cargo clippy             # 代码检查
cargo doc --open         # 生成文档

项目结构

my_project/
├── Cargo.toml      # 项目配置
└── src/
    └── main.rs     # 源代码

Cargo.toml:

toml
[package]
name = "my_project"
version = "0.1.0"
edition = "2024"

[dependencies]

配置开发环境

VS Code 配置(推荐)

安装扩展:

扩展用途
rust-analyzer代码补全、类型提示(必须)
CodeLLDB调试支持
Better TOMLCargo.toml 语法高亮

其他编辑器

编辑器插件
IntelliJ IDEARust 插件
Vim/Neovimrust.vim + rust-analyzer
Emacsrust-mode + lsp-mode

调试模式 vs 发布模式

bash
cargo build              # 调试模式(编译快,运行慢)
cargo build --release    # 发布模式(编译慢,运行快)
模式编译速度运行速度输出目录
debugtarget/debug/
release快(10-100倍)target/release/

小结

  • 通过 rustup 安装和管理 Rust 工具链
  • rustc(编译器)、cargo(包管理)是两大核心工具
  • VSCode + rust-analyzer 是推荐的开发环境组合
  • rustup update 保持工具链最新

练习题

详见:练习题