Tauri 官方提供了一套命令行脚手架工具 create-tauri-app,它能够帮助你在几十秒内搭建出一个结构完整、可直接运行的基础项目。不需要手动配 WebView、Rust 依赖或前端构建工具,一条命令全部搞定。
使用方式
根据你的包管理器偏好,任选一种运行方式:
# npm
npm create tauri-app@latest
# yarn
yarn create tauri-app
# pnpm
pnpm create tauri-app
# Cargo(Rust 包管理器)
cargo install create-tauri-app
cargo create-tauri-app
你还可以直接在命令后面跟上项目名,跳过交互式提示:
npm create tauri-app@latest my-app
交互过程
运行命令后,工具会依次询问几个关键选项:
- 项目名称:输入你的应用名称,默认会用作文件夹名。
- 前端框架:从列表中选取你喜欢的框架或构建工具,如 React、Vue、Svelte、Solid、Vanilla(纯 HTML/JS)等。工具会自动生成对应的前端模板。
- 包管理器:选择 npm、yarn 或 pnpm。
- UI 模板(可选):有些框架会提供更丰富的模板,比如 React + TypeScript 或 Vue + Sass。
整个过程只需按几下回车,脚手架就会完成以下工作:
- 创建一个规范的目录结构;
- 初始化前端项目(Vite 配置、依赖安装);
- 在
src-tauri目录下生成 Rust 工程(Cargo.toml、main.rs、tauri.conf.json 等); - 配置好 Tauri CLI,使
npm run tauri dev等命令立即可用。
生成的项目结构一览
my-app/
├── src/ # 前端源码(Vite 默认入口)
├── src-tauri/ # Tauri 后端 Rust 工程
│ ├── Cargo.toml # Rust 依赖配置
│ ├── tauri.conf.json # Tauri 应用配置(窗口大小、权限等)
│ ├── src/
│ │ └── main.rs # Rust 入口,可在此定义自定义命令
│ └── icons/ # 应用图标
├── public/ # 静态资源
├── package.json # 前端依赖与脚本
└── vite.config.ts # Vite 配置(已适配 Tauri)
立刻运行
创建完成后,进入项目目录,运行开发模式:
cd my-app
npm run tauri dev
这会同时启动前端开发服务器(默认 Vite)和一个系统 WebView 窗口,支持热更新。修改前端代码,窗口会立即刷新;修改 Rust 代码,后台会自动重新编译并重启。
实用提示
- 如果你只想快速试验,可以在交互中选择 “Vanilla” 框架,生成一个最简的 HTML 页面,降低学习负担。
- 生成的
tauri.conf.json中包含详细的窗口配置、允许调用的 API 权限等,所有安全策略都默认设为“关闭”,你需要按需打开。 - 脚手架默认使用 Vite 作为前端构建工具,如果你偏好 Webpack 或 Parcel,可以在创建后手动调整,但 Vite 目前是 Tauri 社区最推荐的选项,因为它冷启动快、配置简单。
一句话总结:create-tauri-app 是进入 Tauri 世界的最快入口,它把前端和 Rust 的初始工程化工作压缩成了一条命令,让你把精力集中在编写业务逻辑上,而不是折腾配置。