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 环境的必装组件、推荐组件、安装步骤、验证方法和常见问题,避免将编辑器插件与编译环境混淆。

相关推荐
普通人623 分钟前
PHP多维数组排序完全指南
开发语言·php·1024程序员节
starzy199010 小时前
深入理解Scala隐式类:扩展方法机制
开发语言·人工智能·scala
M--Y11 小时前
LangGraph 工作流模式
开发语言·javascript·python·langchain·大模型·llm·langgraph
吴可可12312 小时前
WScript Shell操作注册表详解
开发语言
纪念 22913 小时前
C++ 算法基础 (差分)
开发语言·c++·算法
wflynn15 小时前
GitHub 今日推荐|Stela:在 PC 上直接启动 macOS 的翻译层
rust·开源·github
aifannihao16 小时前
Rust 1.100 的 DropGuard:用 Python 实测失败回滚与吞异常
python·rust·异常处理·标准库·contextlib
码农小河6617 小时前
基于PHP的电商后台蜜罐系统
开发语言·php
starzy199017 小时前
深入理解Scala柯里化函数:函数链式变换
开发语言·scala
ShineWinsu18 小时前
对于Qt:QTreeWidget常见属性以及QTreeWidgetItem类的解析
开发语言·c++·qt·gui·客户端·多叉树·qtreewidget