Tauri 开发环境 Prerequisites 桌面 + 移动端）

1. 先做一个选择题：你要做哪种目标

你只需要安装与你的目标匹配的依赖：

只做桌面端（Windows/macOS/Linux）
- System Dependencies + Rust
- 如果 UI 用 React/Vue 等，再装 Node.js
做移动端（Android/iOS）
- 桌面端全部依赖 + 移动端额外依赖（Android Studio / Xcode 等） (Tauri)

2. Linux：系统依赖怎么装（以 Debian/Ubuntu 为例）

Tauri 在 Linux 上需要 WebView（GTK WebKit）、构建工具链、OpenSSL、托盘/图标相关库等。不同发行版包名会有差异。 (Tauri)

Debian/Ubuntu 常用依赖（官方示例）：

bash 复制代码

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

几个经验点：

看到 openssl-sys 相关报错，优先检查 libssl-dev / openssl 开发包是否安装齐全；必要时设置 OPENSSL_DIR。 (GitHub)
如果你在对照旧文章（Tauri v1）装 libwebkit2gtk-4.0-dev，在新系统（如 Ubuntu 24）可能会遇到仓库里没有的情况；v2 文档用的是 4.1。 (GitHub)
打包 Debian 包时，运行时依赖一般会包含 libwebkit2gtk-4.1-0、libgtk-3-0，托盘用到还会带 libappindicator3-1（这有助于你排查"运行环境缺库"问题）。 (Tauri)

装完 Linux 依赖后，下一步直接装 Rust。

3. macOS：Xcode 是关键

macOS 上 Tauri 依赖 Xcode 及其相关开发组件，安装来源两种：

Mac App Store
Apple Developer 网站下载

安装后一定要启动一次 Xcode ，让它完成首次配置。 (Tauri)

仅做桌面端：装好 Xcode → 继续安装 Rust

要做 iOS：除了 Xcode，还要按 iOS 章节继续装 targets、Homebrew、CocoaPods（后面会写）。 (Tauri)

4. Windows：C++ Build Tools + WebView2（MSI 还可能需要 VBSCRIPT）

4.1 安装 Microsoft C++ Build Tools

安装 Visual Studio C++ Build Tools 时，勾选 "Desktop development with C++" （桌面 C++ 开发）。 (Tauri)

4.2 安装 WebView2 Runtime

Tauri 在 Windows 用 Microsoft Edge WebView2 渲染内容。

Windows 10（1803+）/ Windows 11 通常已预装 WebView2，可跳过安装步骤
如果缺失，安装 WebView2 Runtime（文档建议 Evergreen Bootstrapper） (Tauri)

4.3 只有当你要打 MSI 安装包时：检查 VBSCRIPT

当你的 tauri.conf.json 使用 "targets": "msi" 或 "targets": "all"，构建 MSI 可能会依赖系统的 VBSCRIPT 可选功能；若遇到类似 light.exe 执行失败，可去 Windows 可选功能里启用 VBSCRIPT。 (Tauri)

做完 Windows 依赖后，下一步装 Rust。

5. Rust：所有平台都必须装（用 rustup）

Tauri 基于 Rust，因此开发必装 Rust 工具链。官方推荐 rustup： (Tauri)

bash 复制代码

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

安装后建议：

关闭并重开终端（有时需要重启系统）让 PATH 生效 (Tauri)

6. Node.js：只有当你用 JS 前端生态时才需要

如果你的 UI 用 React/Vue/Svelte 等 JavaScript 生态，就安装 Node.js（建议 LTS），并验证：

bash 复制代码

node -v
npm -v

想用 pnpm / yarn 等，可以按需启用 corepack：

bash 复制代码

corepack enable

同样建议重开终端确保命令可用。 (Tauri)

7. 移动端额外依赖：Android / iOS

7.1 Android（跨平台都能做）

核心步骤：

安装 Android Studio
设置 JAVA_HOME（指向 Android Studio 的 JBR）
用 SDK Manager 安装：Platform、Platform-Tools、NDK（Side by side）、Build-Tools、Command-line Tools
设置 ANDROID_HOME、NDK_HOME
用 rustup 添加 Android targets (Tauri)

环境变量示例（Linux/macOS）：

bash 复制代码

export JAVA_HOME=/opt/android-studio/jbr
export ANDROID_HOME="$HOME/Android/Sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

添加 targets：

bash 复制代码

rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

常见坑：

tauri android init 报 NDK_HOME environment variable isn't set：基本就是 NDK 没装或环境变量没指到正确 NDK 目录。 (GitHub)

7.2 iOS（仅 macOS）

iOS 开发必须是 macOS + Xcode（注意是 Xcode 本体，不是只装 Command Line Tools）。 (Tauri)

步骤：

rustup 添加 iOS targets

bash 复制代码

rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

安装 Homebrew

bash 复制代码

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 CocoaPods

bash 复制代码

brew install cocoapods

完成后就可以进入创建项目/初始化移动端的流程。 (Tauri)

8. 快速自检清单（装完别急着开写代码）

你可以用这几个"最小验证"确认环境 OK：

Rust 是否可用：rustc -V、cargo -V
Node 是否可用（如需要）：node -v、npm -v
Windows：是否装了 C++ Build Tools；WebView2 是否存在（Win10 1803+ 通常无需额外装） (Tauri)
Linux：libssl-dev / WebKitGTK dev 包是否装齐（遇到 openssl-sys 错误优先查这块） (GitHub)
Android：ANDROID_HOME、NDK_HOME 是否指向正确目录 (GitHub)