Windows安装Rust环境详细教程

本文详细介绍了在Windows系统上从零开始配置Rust开发环境的完整流程，涵盖使用官方rustup工具一键安装Rust编译器与Cargo包管理器、验证环境变量、手动修复PATH路径、安装必需的Visual Studio C++构建工具以支持本地代码编译，以及可选但强烈推荐的VS Code + rust-analyzer高效开发配置；步骤清晰、实操性强，专为Windows新手开发者量身打造，助你快速迈出Rust编程的第一步。

如果您希望在Windows系统上开始Rust编程，需要安装Rust编译器、Cargo包管理器及配套工具链。rustup是官方推荐的Rust工具链安装与管理工具，可一键完成安装、版本切换和组件更新。以下是使用rustup安装配置Rust开发环境的具体步骤：

一、下载并运行rustup-init.exe安装程序

rustup-init.exe是rustup的Windows原生安装脚本，它会自动下载Rust工具链并完成初始化配置。该程序不依赖PowerShell或命令行环境预装，适合所有Windows用户。

1、访问https://rustup.rs，在浏览器中直接下载rustup-init.exe文件。

2、右键下载的rustup-init.exe，选择“以管理员身份运行”。

3、安装程序启动后，按回车键接受默认选项（即安装稳定版Rust、将cargo bin目录加入PATH、启用帮助文档）。

4、等待终端显示“Rust is installed now. Great!”，表示安装成功。

二、验证安装并检查环境变量配置

安装完成后，需确认rustc、cargo命令是否可用，并验证系统PATH是否已正确添加Cargo的bin目录。若未生效，可能因终端未重新加载环境变量或安装时未勾选对应选项。

1、打开新的Windows PowerShell或CMD窗口（必须新开，旧窗口不识别新PATH）。

2、执行命令：rustc --version，查看Rust编译器版本输出。

3、执行命令：cargo --version，确认Cargo包管理器已就绪。

4、执行命令：echo %PATH%，查找路径中是否包含类似C:\Users\用户名\.cargo\bin的条目。

三、手动配置PATH（当自动配置失败时）

若第二步中cargo或rustc命令提示“不是内部或外部命令”，说明rustup未成功写入系统PATH。此时需手动将Cargo的bin目录添加至用户环境变量。

1、按下Win + R，输入sysdm.cpl，回车打开“系统属性”。

2、切换到“高级”选项卡，点击“环境变量”按钮。

3、在“用户变量”区域选中“Path”，点击“编辑”。

4、点击“新建”，填入路径：C:\Users\%USERNAME%\.cargo\bin（请将%USERNAME%替换为当前登录用户名，如C:\Users\Alice\.cargo\bin）。

5、连续点击“确定”保存全部设置，然后重启终端窗口。

四、安装Visual Studio C++构建工具（必需依赖）

Rust在Windows上编译本地代码（如std库、第三方crate含C绑定）时，需调用Microsoft C++ Build Tools中的链接器与头文件。缺少该组件将导致cargo build失败，报错含“linker `link.exe` not found”。

1、访问https://visualstudio.microsoft.com/visual-cpp-build-tools/，下载Build Tools for Visual Studio。

2、运行安装程序，勾选“C++ build tools”工作负载，确保同时选中“Windows 10/11 SDK”和“CMake tools for Visual Studio”（可选但推荐）。

3、点击“安装”，等待完成。

4、安装完毕后，重启终端，执行cargo new hello_world && cd hello_world && cargo run测试完整构建流程。

五、配置VS Code进行Rust开发（可选但推荐）

VS Code配合rust-analyzer插件可提供语法高亮、跳转定义、实时检查等IDE级体验。该配置独立于rustup安装，但需确保Rust工具链已就绪。

1、从https://code.visualstudio.com/下载并安装VS Code。

2、启动VS Code，在扩展市场搜索并安装rust-analyzer（官方维护，非“Rust”旧插件）。

3、创建新文件夹，在其中执行cargo init生成Cargo.toml。

4、用VS Code打开该文件夹，等待右下角状态栏出现rust-analyzer: ready提示。

5、新建src/main.rs，输入示例代码，观察错误检查与补全是否即时响应。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Windows安装Rust环境详细教程》文章吧，也可关注golang学习网公众号了解相关技术文章。