Tauri跨平台桌面应用开发实战

Tauri 跨平台桌面应用开发实战 · 教程导读

「Tauri」是个把装配思维写进架构的桌面框架：系统自带的 WebView 做壳，负责把你的 Web 界面渲染出来；Rust 编译出的二进制做芯，负责文件、窗口、进程与安全这些"水电工程"；壳与芯之间靠命令和事件互通消息。把你已经写好的 Web 应用装进这座壳芯合体的房子，它就成了能双击安装的桌面程序——安装包以 MB 计，芯里跑的是内存安全的系统级代码。

这套"壳芯分工"直接回应了桌面开发里最老的两笔账。其一是体积与内存：传统方案给每个应用都塞进整台浏览器内核，装好动辄上百 MB，空跑也要吃掉几百 MB 内存，而 Tauri 复用 Windows 的 WebView2、macOS 的 WKWebView、Linux 的 WebKitGTK，示例项目的安装包通常只有几 MB。其二是安全：Web 层天然暴露在不可信输入面前，Tauri 干脆把所有系统能力收进 Rust 芯，再配上门禁卡式的 Capabilities 权限清单——前端拿不到的能力，页面被注入再多脚本也偷不走。Tauri 2 于 2024 年秋转正，同时把 iOS 与 Android 收进同一套工具链，"装配"的适用范围从桌面延伸到了口袋里。

本册的主线：一份装配记

市面上不缺 Tauri 的 API 速查，缺的是回答"这些东西为什么长这样、装到哪里"的地图。本册的主调是壳与芯装配记：把学框架当成走一条装配线——

• 认识装配对象：壳是什么、芯是什么、装配完的产品和 Electron 这类"自带内核"的方案差在哪（第 1 章）；
• 读懂装配图纸：三层架构、命令调用走过的传送带、WebView 壳体的平台差异、应用从启动到退出的时序（第 2 章）；
• 开工备料：装环境、跑脚手架、逐项读懂装配说明书 tauri.conf.json（第 3 章）；
• 装壳：接前端框架、用 invoke 调 Rust、用事件同步状态、定制无边框窗口（第 4 章）；
• 造芯：写命令、管状态、封系统能力、做错误处理（第 5 章）；
• 上锁：默认安全策略、Capabilities 权限清单、CSP 防注入、代码签名（第 6 章）；
• 取标准件：官方插件矩阵、自定义插件、托盘通知快捷键这些深集成（第 7 章）；
• 出厂上路：构建流水线、多平台安装包、自动更新、性能优化（第 8 章）。

装配线的次序不是随便排的：不懂架构（第 2 章）就看不懂权限为什么按窗口和来源划分；没造过芯（第 5 章）就体会不到安全锁（第 6 章）锁的到底是什么；插件（第 7 章）和打包（第 8 章）则把前面所有零件交给用户。

图 0-1：全册装配知识地图

地图里三条横带对应装配线的三段：认知段（第 1–3 章）解决"是什么、凭什么、怎么开始"；装配段（第 4–6 章）是主车间，装壳与造芯两条工序在第 6 章的安全锁处汇合——因为壳暴露的每个接口都是芯的门面，门面不设防，壳装得再漂亮也是漏的；交付段（第 7–8 章）把成品装上标准件、送出工厂。全书的代码示例围绕同一条故事线展开：一个名为"随身笔记"的桌面应用，从空项目一路装配到带托盘、能自更新的 1.0 版本。

适合谁读

• 有 Web 前端基础、想给产品做个桌面客户端的工程师：你不需要会 Rust。第 5 章会从零讲命令与状态，所有 Rust 示例都带注释、可直接抄进项目。
• 被 Electron 体积与内存困扰的团队：第 1 章的对比与第 8 章的瘦身清单，可以帮你估算迁移成本。
• 想系统理解"Web 技术栈如何落进操作系统"的学习者：第 2 章的架构拆解不绑定版本，讲的是十年内都不会过时的机制。

前置要求只有三条：会用一种前端框架或纯 HTML 也行、命令行不陌生、最好写过一点任意静态类型的语言。Rust 相关语法在用到处即时解释，不要求先修。

怎么用这本教程

本册是"动手优先"的排布：每章都有能跑的命令与代码，建议机器上常备一个实验项目，读到哪装到哪。三个建议：一是第 3 章的项目创建务必亲手敲一遍，后文所有示例都以它为基准；二是第 4、5 章的"随身笔记"功能示例互相衔接，跳章读会缺上下文；三是第 6 章安全模型建议在写完第一个功能后就回头读，权限清单是越早立规矩越省事的典型。

版本与约定

全书以 Tauri 2 稳定版为准：配置用 v2 格式的 tauri.conf.json，权限体系用 Capabilities，前端包统一走官方插件。Tauri 1 的旧写法（allowlist、tauri.conf.json 的 v1 结构）与本书不兼容，遇到旧资料请以官方迁移指南对照。代码块里出现的命令默认在项目根目录执行，Rust 代码默认位于 src-tauri 侧、前端代码默认位于前端工程侧，环境差异导致的命令出入以官方文档为准。