Banner

tauri 界面介绍及安装教程

2026-10-08

Tauri 界面组成

界面能看到什么用途
应用窗口前端页面、原生标题栏、窗口按钮查看 UI 效果
终端日志tauri dev 输出、Rust 编译信息查看后端状态
前端调试浏览器 DevTools调试 HTML/CSS/JS
配置文件tauri.conf.json设置窗口、权限、打包
权限文件capabilities/default.json控制前端能调用哪些能力
项目结构src/ + src-tauri/区分前端与 Rust 后端


默认窗口通常是一个原生桌面窗口,里面加载你写的前端页面;它不像 Electron 那样自带一套统一界面,而是完全由前端决定 UI 样式。

安装教程

1. 安装系统依赖

Windows:

  • 安装 Microsoft C++ Build Tools,勾选“使用 C++ 的桌面开发”。
  • 安装或确认 WebView2 Runtime 已存在,Win10 1803+ 和 Win11 通常已内置。

macOS:

xcode-select --install

Linux / Ubuntu:

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

不同 Linux 发行版包名可能略有差异,以官方文档为准。

2. 安装 Rust

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

Windows 可下载 rustup-init.exe 安装。

验证:

rustc --version
cargo --version

3. 安装 Node.js

推荐安装 Node.js 18+ LTS。

验证:

node -v
npm -v

4. 创建 Tauri 项目

npm create tauri-app@latest

按提示选择:

  • 项目名称
  • Identifier,例如 com.example.app
  • 前端语言:TypeScript / JavaScript
  • 包管理器:npm / pnpm / yarn
  • 前端模板:React / Vue / Svelte / Solid / Vanilla

然后进入项目目录:

cd my-tauri-app
npm install

5. 启动开发窗口

npm run tauri dev

首次运行会编译 Rust 依赖,耗时较长;后续增量编译会快很多。

启动成功后会弹出原生应用窗口,同时终端会显示 Rust 日志。前端页面修改通常支持热更新,Rust 代码修改后会自动重启。

6. 打包发布

npm run tauri build

产物默认输出在:

src-tauri/target/release/bundle/

常见安装包格式:

平台产物
Windows.exe / .msi
macOS.app / .dmg
Linux.deb / .rpm / .AppImage

打包需要在对应系统上进行,Tauri 不支持跨平台交叉编译。

项目结构速览

my-tauri-app/
├── src/                  # 前端代码
├── src-tauri/            # Rust 后端
│   ├── src/
│   │   ├── lib.rs        # 主要逻辑入口
│   │   └── main.rs       # 桌面入口
│   ├── Cargo.toml        # Rust 依赖
│   ├── tauri.conf.json   # 应用配置
│   ├── capabilities/     # 权限配置
│   └── icons/            # 应用图标
├── package.json
└── index.html

核心记忆点:前端写界面,Rust 写能力,tauri.conf.json 管窗口,capabilities/ 管权限,npm run tauri dev 启动窗口,npm run tauri build 生成安装包。


11