Windows 环境搭建

Windows 是 Tauri 2.x 支持得最”现成”的平台之一，因为微软把 WebView2 几乎预装到了每台 Win10/Win11 机器上。但”几乎”不等于”一定”，而且 Rust 在 Windows 上必须配 MSVC 工具链，这一步漏了就会在编译期爆出一堆链接错误。本章按”先查后装、逐样验证”的顺序走，避免你装完一堆东西却不知道哪样没生效。

先确认你的 Windows 版本

WebView2 从 Windows 10 版本 1803（2018 年 4 月更新） 起随系统分发，Windows 11 同样自带。所以第一步不是闷头下载，而是先确认版本：

• 按 Win + R，输入 winver 回车，看弹窗里的版本号。
• 如果是 Win10 1803 及以上，或任意版本的 Win11，WebView2 大概率已经躺在系统里了。

安装 Microsoft C++ 生成工具（MSVC）

Tauri 的 Rust 代码最终要用微软的链接器（link.exe）生成 .exe，这个链接器来自 Microsoft C++ 生成工具（Visual Studio Build Tools）。它是 Windows 上最容易漏装的一项。

方法一：图形界面安装（推荐新手）

1. 访问微软官网下载”Visual Studio 生成工具”安装程序并运行。
2. 在工作负载列表里勾选 使用 C++ 的桌面开发（英文界面叫 “Desktop development with C++”）。
3. 右侧”安装详细信息”里，确认勾选了 MSVC v14.x 和 Windows 10/11 SDK。SDK 提供系统头文件，缺了也会编译失败。
4. 点安装，等待完成（体积不小，耐心等）。

方法二：命令行一键安装（适合爱敲命令的你），用 winget 直接带上所需工作负载：

winget install Microsoft.VisualStudio.2022.BuildTools --override "--add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Component.Windows11SDK.22621"

安装完必须重启一次终端（建议重启电脑），让环境变量 PATH 里出现 link.exe 等工具。

安装 WebView2 运行时

如果你的系统里没有 WebView2（多见于老旧 Win10 或定制精简系统），去微软官网下载”Evergreen Bootstrapper”（常青版引导程序）并运行。它名字里带”引导程序”，意思是它会在后台拉取并常驻更新，保证 WebView2 始终是最新版。

装完不用单独”验证 WebView2”，因为它只是个系统组件。真正的验证会在你第一次 tauri dev 弹窗时完成：窗口能正常显示网页，就说明它在工作。

安装 Rust（务必选 MSVC 工具链）

Rust 官方提供 rustup-init.exe 安装程序。运行后它会问你默认工具链，请确认 default host triple 选的是 MSVC，而不是 GNU。对应关系：

• 64 位 Intel/AMD 机器：x86_64-pc-windows-msvc
• 32 位机器：i686-pc-windows-msvc
• ARM64 机器：aarch64-pc-windows-msvc

如果你已经装过 Rust 但当初选了 GNU，用这条命令切回 MSVC：

rustup default stable-msvc

也可以用 winget 装 rustup，再由它安装工具链：

winget install --id Rustlang.Rustup

装完重启终端，验证：

rustc --version
cargo --version

两个都有版本号，发动机就位了。

安装 Node.js 与包管理器

如果要用 Vue/React/Svelte 等前端框架，去 Node.js 官网装 LTS 版本。推荐用 nvm-windows 管理多版本：

nvm install 20
nvm use 20
node -v
npm -v

想用 pnpm 或 yarn，先开启 corepack：

corepack enable

不开启就用默认 npm，完全没问题。

验证整套环境

把前面的命令串起来跑一遍，确认三样都在：

rustc --version      # Rust 编译器
cargo --version      # Rust 包管理/构建
node -v              # Node.js（用 JS 前端时）

至此，Windows 的开发依赖齐活。下一章讲 macOS，再下一章讲 Linux——它们各自的”系统依赖”长得完全不同。

常见坑与排查

坑一：报错 linker 'link.exe' not found 这是 MSVC 生成工具没装或没生效。回到”安装 Microsoft C++ 生成工具”一节，确认勾选了”使用 C++ 的桌面开发”并装了 Windows SDK，然后重启终端。

坑二：Rust 装成了 GNU 工具链 症状往往是链接阶段找不到 MSVC 的库。用 rustup default stable-msvc 切换，并确认 rustup show 里 active 的是 msvc 而非 gnu。

坑三：窗口一片空白或打不开 优先怀疑 WebView2。确认”已安装的应用”里有 WebView2 Runtime；老旧系统请按本章装好常青版引导程序。

坑四：首次编译卡很久或依赖拉取超时 第一次 tauri dev 要编译数百个 Rust 依赖，耗时三五分钟甚至更久属正常。若明确是网络超时，检查 crates 镜像配置，或给项目单独放一份 .cargo/config.toml。

坑五：打包时提示 wix311-binaries.zip 下载失败 这是生成 .msi 安装包时需要的 WiX 工具被墙。可手动从 WiX 官网下载 wix311-binaries.zip，解压到 C:\Users\你的用户名\AppData\Local\tauri\WixTools\ 目录下（注意：解压后 candle.exe 等文件要直接在该目录里，不要多套一层子文件夹）。

小结

本章在 Windows 上完成了 WebView2 运行时、Microsoft C++ 生成工具（MSVC）、Rust（务必选用 MSVC 工具链）和 Node.js 的安装与验证，并梳理了链接器缺失、GNU 工具链误用、WebView2 缺失、首次编译缓慢、WiX 下载失败等五个高频坑的排查思路。