Tauri 是一个基于 Rust 的跨平台桌面应用框架，因此在 Windows 上开发 Tauri 必须先安装 Rust、Cargo、C++ 构建工具等依赖。 以下是从零开始的完整安装流程。

1. 安装 Rust（包含 cargo）

Rust 官方推荐使用 rustup 安装。

1.1 使用 winget 安装（最简单）

winget install Rustlang.Rustup

安装完成后， **关闭 PowerShell，重新打开一个新的 PowerShell **，然后检查：

rustup --version
cargo --version
rustc --version

如果能看到版本号，说明 Rust 安装成功。

2. 如果 rustup / cargo 无法识别（常见问题）

如果你看到：

无法将“cargo”识别为 cmdlet...

说明 PATH 没刷新。

解决方法：

2.1 关闭 PowerShell → 重新打开

大多数情况下，这一步即可解决。

2.2 手动运行 rustup-init（如果 PATH 仍无效）

rustup-init.exe

如果找不到：

where rustup-init.exe

找到后双击运行，选择默认安装。

2.3 手动加入 PATH（最后手段）

Rust 默认安装路径：

C:\Users\<你的用户名>\.cargo\bin

添加到系统 PATH：

• Win + R → 输入 sysdm.cpl
• 点击 **高级 **
• 点击 **环境变量 **
• 编辑系统变量 **Path **
• 添加：

C:\Users\<你的用户名>\.cargo\bin

保存后重新打开 PowerShell。

3. 安装 Visual Studio Build Tools（Tauri 必需）

Tauri 在 Windows 上需要 C++ 构建工具。

使用 winget 安装：

winget install Microsoft.VisualStudio.2022.BuildTools

安装界面中必须勾选：

• **Desktop development with C++ **
• Windows 10/11 SDK

安装完成后重启电脑（可选但推荐）。

4. 安装 Node.js + PNPM（Tauri 前端依赖）

4.1 安装 Node.js（建议 LTS）

winget install OpenJS.NodeJS.LTS

检查：

node -v
npm -v

4.2 安装 pnpm

npm install -g pnpm

检查：

pnpm -v

5. 安装 Tauri CLI

在你的项目目录执行：

pnpm add -D @tauri-apps/cli

或全局安装：

pnpm add -g @tauri-apps/cli

检查：

tauri -V

6. 运行 Tauri 项目

进入你的项目目录：

pnpm tauri dev

如果 Rust、Cargo、C++ 工具链都安装正确，Tauri 会开始编译并启动桌面应用。

7. 常见错误与解决方案

❌ Error: failed to get cargo metadata: program not found

**原因：Rust / Cargo 未安装或 PATH 未生效 **解决：重新打开 PowerShell 或重新运行 rustup-init。

❌ linker link.exe not found

**原因：VS Build Tools 未安装 C++ 工具链 **解决：重新安装 Build Tools 并勾选 “Desktop development with C++”。

❌ Windows SDK not found

解决：在 Build Tools 中勾选 Windows 10/11 SDK。

8. 完整环境检查命令

rustc --version
cargo --version
rustup --version
node -v
pnpm -v
tauri -V

全部正常后，你的 Windows Tauri 环境就完全 OK 了。