快速开始 on 编程那些事儿

1 什么是 Tauri？

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/start/

Tauri 是一个用于为所有主流桌面平台和移动平台构建小巧、快速二进制文件的框架。开发者可以集成任何能编译为 HTML、JavaScript 和 CSS 的前端框架来构建用户界面，同时在需要时借助 Rust、Swift 和 Kotlin 等语言实现后端逻辑。

1 升级与迁移

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/start/migrate/

了解从 Tauri 1.0 升级或从其它框架迁移的常见场景与步骤。

从 Tauri 1.0 升级：了解将版本 1 的项目升级到版本 2 需要做哪些更新。
从 Tauri 2.0 Beta 迁移：了解将 2.0 beta 项目升级到 2.0 需要做哪些更新。

2 从 Tauri 1.0 升级

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/start/migrate/from-tauri-1/

本指南将带你把自己的 Tauri 1.0 应用升级到 Tauri 2.0。

为移动端做准备

Tauri 的移动端接口要求你的项目输出一个共享库。如果你打算让现有应用支持移动端，就必须修改 crate，使其在生成桌面端可执行文件的同时也生成这种产物。

2 前置条件

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/start/prerequisites/

要开始使用 Tauri 构建项目，你需要先安装一些依赖：

系统依赖
Rust
配置移动端目标（仅在为移动端开发时需要）

系统依赖

请按各自的操作系统点击对应链接开始：

Linux（具体发行版见下文）
macOS Catalina (10.15) 及更高版本
Windows 7 及更高版本

Linux

在 Linux 上开发 Tauri 需要各种系统依赖。它们可能因发行版而异，下面列出了一些流行的发行版来帮助你完成配置。

3 创建项目

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/start/create-project/

Tauri 之所以如此灵活，原因之一就是它能与几乎所有前端框架配合使用。我们开发了 create-tauri-app 工具，帮助你使用官方维护的框架模板之一来创建新的 Tauri 项目。

create-tauri-app 目前包含 vanilla（不使用框架的 HTML、CSS 和 JavaScript）、Vue.js、Svelte、React、SolidJS、Angular、Preact、Yew、Leptos 和 Sycamore 的模板。你也可以在 Awesome Tauri 仓库中找到或添加自己的社区模板与框架。

3 从 Tauri 2.0 Beta 升级

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/start/migrate/from-tauri-2-beta/

本指南将带你把自己的 Tauri 2.0 beta 应用升级到 Tauri 2.0 候选发布版。

自动迁移

Tauri v2 CLI 提供了 migrate 命令，可以自动完成大部分迁移流程，并帮助你完成剩余工作：

1
2


npm install @tauri-apps/cli@latest
npm run tauri migrate

1
2


yarn upgrade @tauri-apps/cli@latest
yarn tauri migrate

1
2


pnpm update @tauri-apps/cli@latest
pnpm tauri migrate

1

cargo tauri migrate

在命令行界面参考中进一步了解 migrate 命令。

4 项目结构

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/start/project-structure/

一个 Tauri 项目通常由两部分组成：一个 Rust 项目和一个 JavaScript 项目（可选），典型的目录结构大致如下：

.
├── package.json
├── index.html
├── src/
│ ├── main.js
├── src-tauri/
│ ├── Cargo.toml
│ ├── Cargo.lock
│ ├── build.rs
│ ├── tauri.conf.json
│ ├── src/
│ │ ├── main.rs
│ │ └── lib.rs
│ ├── icons/
│ │ ├── icon.png
│ │ ├── icon.icns
│ │ └── icon.ico
│ └── capabilities/
│ └── default.json

在这个例子中，JavaScript 项目位于顶层，Rust 项目位于 src-tauri/ 内。该 Rust 项目是一个普通的 Cargo 项目，只是多了一些额外的文件：