Windows Rust 环境安装指导

1. 安装目标

本文用于在 64 位 Windows 系统上安装 Rust 开发环境，采用官方推荐的 MSVC 工具链：

x86_64-pc-windows-msvc

完成后应具备以下能力：

• 使用 rustc 编译 Rust 源代码；
• 使用 cargo 创建、构建、运行和管理 Rust 项目；
• 使用 rustup 安装和更新 Rust 工具链；
• 使用 MSVC 和 Windows SDK 完成 Windows 程序链接；
• 在 VS Code 或 Cursor 中获得代码补全、格式化、检查和调试能力。

2. 必须安装的组件

组件	用途	是否必须
Rustup	管理 Rust 工具链、目标平台和组件	必须
Rustc	Rust 编译器	必须
Cargo	项目构建和依赖管理工具	必须
MSVC C++ Build Tools	为 Windows MSVC 目标提供编译和链接工具	必须
Windows SDK	提供 Windows 库、头文件及链接支持	必须
Rustfmt	自动格式化 Rust 代码	推荐
Clippy	检查常见错误和不规范写法	推荐
Rust Analyzer	编辑器代码补全、跳转和错误提示	推荐
Git	拉取源码及部分 Cargo Git 依赖	推荐
VS Code 或 Cursor	代码编辑器	可选
CodeLLDB	断点调试 Rust 程序	可选

3. 安装 Visual Studio Build Tools

先打开 Visual Studio 官方下载页面：

Visual Studio Downloads for Windows

下载并运行 Build Tools for Visual Studio。在安装器中选择：

使用 C++ 的桌面开发

确认右侧安装详细信息至少包含：

• MSVC x64/x86 生成工具；
• Windows 10 SDK 或 Windows 11 SDK；
• C++ CMake tools for Windows（建议安装，部分项目会使用）。

不需要为了编译 Rust 安装完整的 Visual Studio IDE；只安装 Build Tools 即可。

4. 安装 Rustup、Rustc 和 Cargo

打开 Rust 官方安装页面：

Install Rust - Rust Programming Language

下载并运行 rustup-init.exe。安装程序出现选项后，通常直接输入：

使用默认配置安装。默认配置会安装：

• Stable 稳定版工具链；
• rustc；
• cargo；
• Rust 标准库；
• Rust 文档；
• rustfmt；
• clippy。

安装完成后关闭并重新打开 PowerShell，使环境变量生效。

5. 安装推荐组件

在 PowerShell 中执行：

rustup component add rustfmt clippy rust-analyzer

如果组件已经安装，Rustup 会直接提示组件已是最新状态，不会重复安装。

建议同时更新一次稳定版工具链：

rustup update stable
rustup default stable

6. 安装编辑器支持

6.1 VS Code

安装 VS Code：

Visual Studio Code - The open source AI code editor | Your home for multi-agent development

然后在 PowerShell 中安装 Rust Analyzer 和 CodeLLDB：

code --install-extension rust-lang.rust-analyzer
code --install-extension vadimcn.vscode-lldb

也可以打开 VS Code 的扩展页面，搜索并安装：

• rust-analyzer；
• CodeLLDB。

6.2 Cursor

在 Cursor 的扩展页面中搜索并安装：

• rust-analyzer；
• CodeLLDB。

Rust Analyzer 用于代码补全、定义跳转和实时诊断；CodeLLDB 用于断点调试。它们不影响命令行编译。

7. 验证安装结果

重新打开 PowerShell，依次执行：

rustc --version
cargo --version
rustup --version
rustup show
rustfmt --version
cargo clippy --version
rust-analyzer --version

所有命令都能正常输出版本信息，说明 Rust 工具链安装成功。

其中 rustup show 应显示类似内容：

Default host: x86_64-pc-windows-msvc
installed toolchains
stable-x86_64-pc-windows-msvc (active, default)

8. 创建并编译第一个项目

在合适的工作目录打开 PowerShell，执行：

cargo new hello-rust
Set-Location hello-rust
cargo run

正常情况下应看到类似输出：

Hello, world!

常用 Cargo 命令：

cargo check       # 快速检查代码，不生成最终程序
cargo build       # 调试模式编译
cargo build --release  # 发布模式编译
cargo run         # 编译并运行
cargo test        # 运行测试
cargo fmt         # 格式化代码
cargo clippy      # 执行代码质量检查

9. 常见问题

9.1 提示找不到 rustc、cargo 或 rustup

先关闭并重新打开终端。如果仍然找不到，检查用户环境变量 Path 中是否包含：

%USERPROFILE%\.cargo\bin

默认安装位置通常是：

C:\Users\你的用户名\.cargo\bin

9.2 提示 linker link.exe not found

说明 Visual Studio C++ Build Tools 没有安装完整。重新打开 Visual Studio Installer，确认安装了：

• 使用 C++ 的桌面开发；
• MSVC x64/x86 生成工具；
• Windows 10 SDK 或 Windows 11 SDK。

9.3 rust-analyzer 提示 Unknown binary

执行：

rustup component add rust-analyzer

然后重启终端和编辑器。

9.4 Cargo 下载依赖失败

先确认网络能够访问：

https://crates.io
https://static.rust-lang.org

如果处于代理网络中，需要为 Git、Cargo 或系统配置可用的网络代理。不要随意使用来源不明的 Rust 安装包或依赖镜像。

10. 本机当前环境对应情况

本机检查结果如下：

• 已安装 Rust 1.95.0；
• 已安装 Cargo 1.95.0；
• 已安装 Rustup 1.29.0；
• 默认工具链为 stable-x86_64-pc-windows-msvc；
• 已安装 Rustfmt 和 Clippy；
• 已安装 Visual Studio Build Tools、MSVC 和 Windows SDK；
• 已安装 Git、VS Code、Cursor 和 VS Code CodeLLDB；
• 尚需执行 rustup component add rust-analyzer 安装 Rust Analyzer 实际组件；
• 如使用 VS Code，还建议安装 rust-lang.rust-analyzer 扩展。

因此，本机已经具备 Rust 编译条件，补充 Rust Analyzer 后即可获得更完整的编辑器开发体验。

11. 文档变更说明

新增本安装指导，用于明确 Windows Rust 环境的必装组件、推荐组件、安装步骤、验证方法和常见问题，避免将编辑器插件与编译环境混淆。