Rust Logo Rust 开发环境配置

Rust 工具链、Cargo、IDE 完整配置指南

安装 Rust

推荐方式：使用 rustup 安装，可以方便地管理 Rust 版本和工具链
Rust rustup（推荐）

Rust 官方工具链管理器

Windows 安装：
  1. 下载 rustup-init.exe
  2. 运行安装程序
  3. 选择默认配置安装
Linux/Mac 安装：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
官方网站 中文安装指南
验证安装：
rustc --version
cargo --version
rustup --version
国内加速配置

配置国内镜像提升下载速度

1. 使用国内镜像安装：
# Windows (PowerShell)
$env:RUSTUP_DIST_SERVER="https://rsproxy.cn"
$env:RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"
Invoke-WebRequest -Uri https://rsproxy.cn/rustup-init.ps1 -OutFile rustup-init.ps1
.\rustup-init.ps1

# Linux/Mac
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"
curl https://rsproxy.cn/rustup-init.sh | sh
2. 配置 Cargo 镜像：
# 编辑 ~/.cargo/config.toml
[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"

Windows 额外配置

重要：Windows 用户需要安装 MSVC 构建工具才能编译 Rust 项目
Visual Studio Build Tools

微软提供的轻量级构建工具

安装步骤：
  1. 下载 Visual Studio Build Tools
  2. 运行安装程序
  3. 选择 "使用 C++ 的桌面开发"
  4. 确保勾选 "Windows 10/11 SDK"
  5. 完成安装
下载
一键安装方案

使用 rustup 自动安装

运行命令：
# 安装默认工具链
rustup default stable

# 安装 MSVC 目标
rustup target add x86_64-pc-windows-msvc

# rustup 会自动检测并提示安装
# Visual Studio Build Tools
安装完成后重启终端使环境变量生效

开发工具

VS Code VS Code（强烈推荐）
最流行 免费

配合 rust-analyzer 插件

必备插件：
  • rust-analyzer - Rust 语言支持
  • crates - 依赖版本管理
  • Better TOML - 配置文件编辑
官方下载
安装 rust-analyzer：
# 在 VS Code 扩展商店搜索
# rust-analyzer (matklad)
# 点击安装即可
RustRover RustRover（专业选择）
功能最强 新出品

JetBrains 出品的专业 Rust IDE

特点：
  • 开箱即用
  • 强大重构
  • 调试器集成
  • 数据库工具
官方下载
非商业用途可免费使用
IntelliJ IDEA + Rust 插件

使用已有 IDEA 安装

  • 安装 Rust 插件
  • 功能完整
  • 多语言支持
官方下载
Neovim + rust-analyzer

终端编辑器配置

  • 轻量快速
  • 高度定制
  • LSP 支持
# 使用 lazy.nvim 安装
{ "rust-lang/rust-analyzer", ft = "rust" }

Cargo 常用命令

基础命令
# 创建新项目
cargo new 项目名
cargo new --lib 库名

# 构建项目
cargo build
cargo build --release

# 运行项目
cargo run

# 运行测试
cargo test

# 格式化代码
cargo fmt

# 检查代码
cargo check

# 更新依赖
cargo update
高级命令
# 添加依赖
cargo add 包名
cargo add 包名 --features 特性

# 查看依赖树
cargo tree

# 清理构建缓存
cargo clean

# 生成文档
cargo doc --open

# 发布到 crates.io
cargo publish

# 审计安全漏洞
cargo audit

# 查看版本信息
cargo --version
rustc --version

常用 Rust 库

Web 框架
  • • actix-web - 高性能 Web
  • • axum - Ergonomic Web
  • • rocket - 易用 Web 框架
  • • warp - 轻量 Web 框架
数据库
  • • diesel - ORM 框架
  • • sqlx - 异步 SQL
  • • redis - Redis 客户端
  • • mongodb - MongoDB
序列化
  • • serde - 序列化框架
  • • serde_json - JSON 支持
  • • serde_yaml - YAML 支持
  • • toml - TOML 支持
异步编程
  • • tokio - 异步运行时
  • • async-std - 异步标准库
  • • futures - 异步工具
错误处理
  • • anyhow - 简单错误处理
  • • thiserror - 自定义错误
  • • eyre - 错误报告
工具库
  • • clap - CLI 解析
  • • log - 日志门面
  • • tracing - 追踪日志
  • • env_logger - 日志实现

常见问题

配置国内镜像源：

# 编辑 ~/.cargo/config.toml
# 添加以下内容：

[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"

# 或使用中科大镜像
# registry = "https://mirrors.ustc.edu.cn/crates.io-index/"

Rust 的所有权和借用概念确实需要时间理解：

  1. 从基础开始 - 先理解变量、函数、控制流
  2. 理解所有权 - 这是 Rust 的核心概念
  3. 多练习 - 通过实践加深理解
  4. 查看错误信息 - Rust 的编译器错误信息非常友好
推荐资源：《Rust 程序设计语言》（The Book）官方中文版

使用 rustup 管理多个 Rust 版本：

# 查看已安装版本
rustup show

# 安装特定版本
rustup install 1.70.0
rustup install nightly

# 切换默认版本
rustup default 1.70.0
rustup default nightly

# 为项目指定版本
rustup override set 1.70.0

# 更新 Rust
rustup update

# 1. 创建新项目
cargo new hello_rust
cd hello_rust

# 2. 编辑 src/main.rs
fn main() {
    println!("Hello, Rust!");
}

# 3. 运行项目
cargo run

# 4. 构建发布版本
cargo build --release
# 可执行文件在 target/release/ 目录

环境验证

# 验证 Rust 安装
rustc --version
cargo --version
rustup --version

# 创建测试项目
cargo new test-rust
cd test-rust
cargo run

# 输出应为：
# Hello, world!