Rust开发环境搭建教程

#Window系统Rust开发环境搭建教程

一、整体方案（推荐）

在 Windows 上开发 Rust，最稳定组合是：

・ Rust 工具链：rustup

・编译器：MSVC (Visual Studio Build Tools)

・编辑器：VS Code

・语言服务：rust-analyzer

二、安装 Rust（核心步骤）

1. 安装 rustup（官方安装器）

打开浏览器进入：

👉 https://rustup.rs/

下载 Windows 安装程序，然后运行：

bash 复制代码

rustup-init.exe

安装时选择默认即可（推荐选 1）：

复制代码

1) Proceed with installation (default)

2. 验证安装

打开 PowerShell：

bash 复制代码

rustc -V
cargo -V

如果输出版本号，说明 Rust 已安装成功。

三、安装 C++ 编译环境（非常关键🔥）

Rust 在 Windows 默认用 MSVC 工具链，必须装这个：

1. 安装 Visual Studio Build Tools

下载：

👉 https://visualstudio.microsoft.com/visual-cpp-build-tools/

安装时勾选：

・ ✔️ Desktop development with C++

・ ✔️ MSVC v143（或最新）

・ ✔️ Windows 10 SDK

安装完成后重启电脑。

2. 验证编译器

打开 PowerShell：

bash 复制代码

cl

如果能看到 MSVC 版本信息，说明成功。

四、安装 VS Code

下载：

👉 https://code.visualstudio.com/

安装后打开。

五、安装 Rust 插件（关键体验提升）

在 VS Code 扩展商店安装：

必装：

・ ✔️ rust-analyzer

（不要用旧的 Rust (rls)，已经过时）

可选增强：

・ CodeLLDB（调试）

・ Even Better TOML（Cargo.toml 高亮）

六、配置 Rust 项目（测试环境）

1. 创建项目

bash 复制代码

cargo new hello_rust
cd hello_rust
code .

2. 运行项目

bash 复制代码

cargo run

输出：

复制代码

Hello, world!

说明环境完全 OK。

七、VS Code 调试配置（可选但推荐）

安装 CodeLLDB 后：

在 .vscode/launch.json：

json 复制代码

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "lldb",
      "request": "launch",
      "name": "Debug Rust",
      "program": "${workspaceFolder}/target/debug/hello_rust.exe",
      "cwd": "${workspaceFolder}"
    }
  ]
}

八、Rust 项目结构理解（快速入门）

bash 复制代码

hello_rust/
 ├── Cargo.toml   # 项目配置
 └── src/
     └── main.rs  # 入口文件

九、常见问题（非常重要）

1. cargo 失败 / link.exe 报错

👉 99% 是没装 MSVC 或没装 C++ build tools

2. rust-analyzer 不工作

👉 解决：

・重启 VS Code

・确保打开的是项目根目录（有 Cargo.toml）

3. 编译慢

正常，第一次会下载依赖 + LLVM

十、推荐进阶配置（可选）

如果你想更舒服，可以加：

1. 加速国内源（中国用户）

编辑：

bash 复制代码

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

写入：

toml 复制代码

[source.crates-io]
replace-with = "rsproxy"

[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"

十一、一句话总结

👉 Windows 上 Rust 最稳定开发组合：

rustup + MSVC Build Tools + VS Code + rust-analyzer