2.1 跨平台环境准备

搭建 Tauri 开发环境并不复杂，核心只需要三样东西：Rust 工具链、Node.js 以及对应操作系统的构建依赖。 下面针对 Windows、macOS 和 Linux 分别说明，每一步都经过验证，确保你在最短时间内跑起来。

通用前置：Node.js 与 Rust

无论哪个平台，首先确保 Node.js 和 Rust 已安装：

1. 安装 Node.js（建议 LTS 版本）
访问 nodejs.org 下载并安装，版本 ≥16 即可。安装完成后在终端验证：

node -v
npm -v

2. 安装 Rust
打开终端，执行官方安装脚本：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装过程中按默认选项回车即可。安装完成后，务必重新打开终端或者执行 source "$HOME/.cargo/env" 让环境变量生效，然后检查：

rustc --version
cargo --version

注意：Rust 工具链必须包含 stable 版本，Tauri 构建时会自动处理。

Windows 环境

Windows 是 Tauri 支持最好的平台之一，只需安装一个额外的系统组件：

WebView2 运行时
Tauri 依赖 Microsoft Edge WebView2 来渲染前端。Windows 10 和 11 通常已预装（因为 Edge 浏览器包含它），但如果你用的是精简版系统或旧版本，需要手动安装 Evergreen 引导程序。

• 下载地址：WebView2 Runtime
• 选择 “Evergreen Bootstrapper” 运行即可自动安装，全程不需要额外配置。

其他工具推荐（可选）

• 安装 Visual Studio Build Tools：用于编译某些 Rust crate 中的原生模块。如果后续 cargo build 报缺少 link.exe 之类的错误，下载 Visual Studio 生成工具，安装时勾选“C++ 生成工具”工作负载即可。
• 终端建议使用 PowerShell 或 Windows Terminal，确保编码为 UTF-8（默认已是）。

安装完成后，可以直接用 Tauri CLI 快速验证环境：

npm create tauri-app@latest my-tauri-app -- --template vanila
cd my-tauri-app
npm install
npm run tauri dev

如果窗口能正常打开并显示内容，说明 Windows 环境准备完毕。

macOS 环境

macOS 自带 WebView（WKWebView），不需要额外安装浏览器运行时。但需要 Xcode 命令行工具中的编译器。

安装 Xcode Command Line Tools
在终端运行：

xcode-select --install

弹出对话框点击“安装”，等待完成。验证：

xcodebuild -version

看到版本号即成功（不需要完整的 Xcode IDE，仅命令行工具即可）。

注意：macOS 上签名和公证是分发应用时的事，开发阶段无需操心。

同样，用 npm create tauri-app 创建一个项目并运行 cargo tauri dev 即可启动。

Linux 环境

Linux 各发行版依赖略有差异，核心是需要安装 WebKitGTK 和相关的系统库。以下以 Ubuntu / Debian 为例：

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev \
  build-essential \
  curl \
  wget \
  file \
  libxdo-dev \
  libssl-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev

其他发行版（如 Arch、Fedora）的包名类似，Tauri 官方文档有详细列表：docs.tauri.app/start/prerequisites。

提示：部分 Linux 桌面默认没有自带 WebKitGTK，上述命令会一并安装。如果启动时遇到 .so 缺失错误，通常补装对应的 -dev 包即可解决。

安装完成后同样用 npm create tauri-app 验证。

环境诊断小技巧

如果开发过程中遇到奇怪错误，Tauri 提供了一个检查命令：

cargo tauri info

它会收集当前系统、Rust、Node、WebView 版本等所有相关信息，方便定位问题。你也可以在项目目录下运行 npm run tauri doctor（Tauri v1 或某些模板支持）来一键诊断。

小结：跨平台准备的重点是“Rust + Node.js + 系统 WebView 依赖”。Windows 留意 WebView2，macOS 装好命令行工具，Linux 补全系统库。完成这些后，所有平台都可以通过一个命令启动开发服务器，几乎不再有平台差异。