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 常用依赖（官方示例）：

sudoaptupdatesudoaptinstalllibwebkit2gtk-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)

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），并验证：

node-vnpm-v

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

corepackenable

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

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

7.1 Android（跨平台都能做）

核心步骤：

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

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

exportJAVA_HOME=/opt/android-studio/jbrexportANDROID_HOME="$HOME/Android/Sdk"exportNDK_HOME="$ANDROID_HOME/ndk/$(ls-1 $ANDROID_HOME/ndk)"

添加 targets：

rustup targetaddaarch64-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)

步骤：

1. rustup 添加 iOS targets

rustup targetaddaarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

2. 安装 Homebrew

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

3. 安装 CocoaPods

brewinstallcocoapods

完成后就可以进入创建项目/初始化移动端的流程。 (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)