目录
一、前置准备
1.1 系统要求
1.2 必要工具
1.3 安装 Microsoft C++ 生成工具
二、安装 Rust 工具链（核心步骤）
步骤 1：下载安装程序
步骤 2：运行安装程序
步骤 3：等待安装完成
步骤 4：配置环境变量
步骤 5：验证安装
四、开发工具配置（提升效率）
步骤 1：安装 VS Code
步骤 2：安装 Rust 插件
五、第一个 Rust 程序（验证环境）
步骤 1：创建项目
步骤 2：运行程序
六、常见问题解决
1. 安装失败：网络连接问题
2. 环境变量未生效（命令提示「不是内部或外部命令」）
3. 编译错误：缺少 linker（链接器）
4. VS Code 中 rust-analyzer 无法工作
七、总结
正文开始——
以下是针对 Windows 系统的 Rust 运行环境配置详细指南，从基础安装到开发工具配置、常见问题解决均有覆盖，适合新手一步步操作。
Rust 作为一门安全、高效的系统级编程语言，在 Windows 平台有完善的支持。本文将详细介绍在 Windows 10/11 系统中配置 Rust 开发环境的完整步骤，包括工具链安装、开发工具配置、环境验证及问题排查。
一、前置准备
1.1 系统要求
-
操作系统：Windows 7 及以上（推荐 Windows 10 64位或 Windows 11）
-
权限：无需管理员权限（安装路径默认在用户目录）
-
网络：需要联网下载安装包（约 100-200MB）
1.2 必要工具
-
命令行工具：PowerShell（系统自带，推荐）或 命令提示符（CMD）
-
可选：若需编译依赖 C 语言的 Rust 库，你就要进行下面的1.3节安装 Microsoft C++ 生成工具
1.3 安装 Microsoft C++ 生成工具
部分 Rust 库（如涉及系统调用、网络底层的库）依赖 C 语言编译器，Windows 需安装 Microsoft C++ 生成工具（即 MSVC）才能正常编译。
-
访问微软官方下载页：https://visualstudio.microsoft.***/zh-hans/visual-cpp-build-tools/
-
点击「下载生成工具」，获取
vs_buildtools.exe并运行
- 在弹出的安装界面中，（1）勾选 「使用 C++ 的桌面开发」（无需勾选其他组件），（2）按照原始的默认勾选即可
-
点击「安装」，等待下载并安装（约 1-2GB，视网络情况而定）
-
安装完成后，重启电脑使配置生效
二、安装 Rust 工具链（核心步骤）
Rust 官方推荐使用 rustup 管理工具链，它会自动安装编译器（rustc）、包管理器（cargo）及相关工具，并支持版本切换。
步骤 1：下载安装程序
-
打开浏览器，访问 Rust 官网工具页面：https://www.rust-lang.org/tools/install
-
点击页面中的 "Download rustup-init.exe (x64)"，若为 32位系统可选择下方的 32-bit 版本
-
下载完成后，找到
rustup-init.exe（默认在「下载」文件夹）
步骤 2：运行安装程序
-
双击
rustup-init.exe，会自动启动 PowerShell 窗口（若弹出「用户账户控制」提示，点击「是」）
-
窗口中会显示安装选项，默认提示为：
1) Proceed with installation (default)
2) Customize installation
3) Cancel installation直接按 Enter 键 选择默认安装（推荐新手），安装程序会自动开始下载并配置工具链。
步骤 3：等待安装完成
-
安装过程中会显示进度，主要下载
rustc、cargo、rust-std（标准库）等组件 -
完成后会显示提示：
Rust is installed now. Great!
-
此时，我们需要手动将 Rust 的二进制目录（
%USERPROFILE%\.cargo\bin）添加到系统环境变量中
步骤 4：配置环境变量
- 打开
C:\Users\你的用户名\.cargo\bin，复制这个路径
- 右键「此电脑」→「属性」
- 点击「高级系统设置」
- 「高级」→「环境变量」
- 「系统变量」→「Path」→「新建」→ 粘贴我们刚才复制的路径 →「确定」
- 点击每个窗口的「确定」，逐步关闭窗口
步骤 5：验证安装
-
重新打开 PowerShell 或 CMD
-
输入一下命令：
rustc --version # 查看 Rust 编译器版本
cargo --version # 查看 Cargo 包管理器版本-
若输出类似以下信息，说明安装成功：
rustc 1.91.0 (f8297e351 2025-10-28) # Rustc 的版本信息
cargo 1.91.0 (ea2d97820 2025-10-10) # Cargo 的版本这样，就是成功安装Rust工具链啦！
四、开发工具配置（提升效率）
推荐搭配代码编辑器或 IDE 进行开发，下面我来介绍 VS Code（推荐新手，轻量且免费）结合插件来开发
胜利的曙光即将来临，加油！
步骤 1：安装 VS Code
这里简单介绍啦~
-
下载地址：https://code.visualstudio.***/
-
双击安装包，按提示完成安装（建议勾选「添加到 PATH」方便命令行启动）
步骤 2：安装 Rust 插件
-
打开 VS Code，点击左侧菜单栏的「扩展」图标（或按
Ctrl+Shift+X） -
搜索并安装以下插件：
-
rust-analyzer（必装）：官方推荐的 Rust 语言服务器，提供语法高亮、自动补全、错误提示等核心功能
-
Error Lens（可选）：在代码行旁直接显示错误信息，无需查看输出面板
-
Crates（可选）：管理
Cargo.toml中的依赖版本，提示更新
-
五、第一个 Rust 程序（验证环境）
通过经典的「Hello World」程序测试环境是否正常工作：
步骤 1：创建项目
-
我新建了一个专门存放 rust 项目的
rust-运行文件夹，然后进入到这个文件夹
-
接着，删掉红框内的路径，输入 cmd
-
使用
cargo创建新项目
cargo new hello-rust接着关闭这个终端，然后回到我们之前创建存放 rust 文件的文件夹，可以看到我们已经成功新建了 hello-rust项目
接着点击进入我们新建的 hello-rust 项目，进入之后在上方的路径框内输入cmd
-
在终端内输入
code .然后点击回车就可以进入到 vscode 页面
code .这里有一个我们之前成功建立的名为 hello-rust 的文件夹：
包含基础项目结构：
hello-rust/
├── Cargo.toml # 项目配置文件（依赖管理等）
└── src/
└── main.rs # 主程序代码步骤 2：运行程序
main.rs里面原本就会有一段代码，点击run即可
呦吼，成功啦！
六、常见问题解决
1. 安装失败：网络连接问题
-
症状：
rustup-init.exe运行后卡住，或提示「无法连接到服务器」 -
解决：使用国内镜像加速（以中国科学技术大学镜像为例）：
-
打开 PowerShell，执行以下命令设置环境变量：
$env:RUSTUP_DIST_SERVER = "https://mirrors.ustc.edu.***/rust-static" $env:RUSTUP_UPDATE_ROOT = "https://mirrors.ustc.edu.***/rust-static/rustup" -
重新运行
rustup-init.exe进行安装
-
2. 环境变量未生效（命令提示「不是内部或外部命令」）
-
症状：执行
rustc --version提示「'rustc' 不是内部或外部命令」 -
解决：
-
手动检查环境变量：
-
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
-
在「用户变量」的「Path」中确认是否包含
C:\Users\你的用户名\.cargo\bin
-
-
若缺失，点击「编辑」→「新建」，添加上述路径
-
重启命令行窗口后重试
-
3. 编译错误：缺少 linker（链接器）
-
症状：编译时提示
error: linker 'link.exe' not found -
解决：安装前文提到的「Microsoft C++ 生成工具」，确保勾选「使用 C++ 的桌面开发」
4. VS Code 中 rust-analyzer 无法工作
-
症状：代码无高亮、补全，提示「rust-analyzer server not started」
-
解决：
-
检查
rust-analyzer是否安装：在 PowerShell 中执行cargo install rust-analyzer -
重启 VS Code，或按
Ctrl+Shift+P执行「Rust Analyzer: Restart Server」
-
七、总结
在 Windows 系统中，通过 rustup-init.exe 可快速安装 Rust 工具链，搭配 VS Code 工具即可搭建完整的开发环境。若遇到网络或编译问题，可参考本文的「常见问题解决」部分排查。
完美结束！
