用 create-tauri-app 创建项目

手写一个 Tauri 项目要从零拼配置、写 Rust 入口、接前端，对新手并不友好。官方因此提供了一个脚手架（scaffold）工具 create-tauri-app，把常见前端框架的模板都准备好了。你只要回答几个问题，它就把目录、配置、示例代码一次性摆好。这一章我们就把这个工具从头到尾跑一遍。

什么是 create-tauri-app

create-tauri-app 是 Tauri 官方维护的「项目生成器」。它和前端圈熟悉的 create-vite、create-react-app 是一类东西：用一个命令，按你的选择吐出一个可直接运行的项目骨架。

Tauri 的好处之一，是它几乎能跟任意前端框架配合，所以它内置的模板覆盖了原生 HTML/CSS/JS、Vue、Svelte、React、SolidJS、Angular、Preact，还有 Rust 系的 Yew、Leptos、Sycamore，以及 .NET 的 Blazor。你不用自己搭桥，脚手架已经把框架和 Tauri 后端接好了。

运行脚手架命令

打开终端，进入你打算放项目的目录，执行下面这条命令（版本基线以 2.x 为准，直接用 @latest）：

npm create tauri-app@latest

在 Linux 和 macOS 上用 Bash 执行即可；Windows 用户用 PowerShell 或 Git Bash 跑同样的命令也没问题。执行后，工具会先下载最新模板，然后进入交互式问答。

如果你的系统缺少某些前置依赖（比如没装 Rust 或 Node.js），脚手架在最后会打印一份缺失清单和安装提示，你照着补装即可。前置环境怎么配，前面章节已经讲过，这里不再展开。

交互选项逐一拆解

脚手架会依次问你几组问题，我们一个一个说清楚它在问什么、怎么选。

第一问是项目名称，默认叫 tauri-app。它既是文件夹名，也会写进多处配置。直接回车用默认值，或输入你喜欢的名字（建议小写、用连字符，例如 my-tauri-app）。

第二问是应用标识符（identifier），默认 com.tauri-app.app。这是一个反向域名（reverse domain name）格式的唯一标识，像 com.你的公司.应用名。它会在系统里区分你的应用，打包和升级时都离不开它。新手可以先用默认值，等真要发布再改成自己的域名倒写。

第三问是前端语言，通常给三个方向：

? Choose which language to use for your frontend
  Rust   (cargo)
  TypeScript / JavaScript  (pnpm, yarn, npm, bun)
  .NET   (dotnet)

绝大多数读者走 TypeScript / JavaScript 这条路，用熟悉的 Web 技术写界面；想纯 Rust 渲染可选第一项；.NET 开发者选第三项。

第四问是包管理器。如果你选了 TypeScript/JavaScript，会让你在 pnpm、yarn、npm、bun 里挑一个。选你顺手的，没有就选 npm。

UI 框架与风格怎么选

接下来是** UI 模板**。选 TypeScript/JavaScript 时会列出：Vanilla、Vue、Svelte、React、Solid、Angular、Preact。选 Rust 时则是 Vanilla、Yew、Leptos、Sycamore。

模板定下后还会追问风格（flavor），例如 Vanilla 会让你选 TypeScript 还是 JavaScript，Vue/React 等也会区分 TS 与 JS 版本。

全部回答完，脚手架会报告「模板已创建」，并打印出如何用你选的包管理器运行项目。到这里，磁盘上就多了一个完整的项目文件夹。

生成后的初始项目长什么样

脚手架生成的项目，顶层是前端工程，里面嵌套了一个 src-tauri/ 目录放 Rust 后端。一个最简 Vanilla 项目大致是这样：

my-tauri-app/
├── index.html          # 前端入口 HTML
├── package.json        # 前端依赖与脚本
├── src/                # 前端源码（main.ts 等）
├── src-tauri/          # Tauri / Rust 后端
│   ├── Cargo.toml      # Rust 依赖清单
│   ├── build.rs        # 构建脚本
│   ├── tauri.conf.json # Tauri 主配置
│   ├── icons/          # 应用图标
│   └── src/
│       ├── main.rs     # 桌面端入口
│       └── lib.rs      # 应用核心逻辑
└── vite.config.ts      # 前端构建配置（框架不同文件名可能不同）

你不必现在就弄懂每个文件。下一章会专门拆解这个目录结构，这里只要知道：脚手架已经把前后端接好，你接下来要做的只是进目录、装依赖、跑起来。

进入项目并启动开发

生成完成后，进入文件夹并安装前端依赖：

cd my-tauri-app
npm install

依赖装好后，用 Tauri CLI 启动开发模式：

npm run tauri dev

这条命令会先编译 Rust 代码，再打开一个桌面窗口，里面跑的就是你的前端页面。第一次编译要拉取并构建一批 Rust 依赖，可能要等几分钟；之后改动代码会快很多。关于开发模式窗口和热更新，我们放到第 12 章细讲。

小结

到这一步，你已经拥有人生第一个能跑的 Tauri 应用窗口了。我们学会了用 npm create tauri-app@latest 脚手架生成项目，理解了项目名称、标识符、前端语言、包管理器和 UI 模板等交互选项的含义，并成功启动了开发窗口。接下来我们先不急着写功能，而是把生成出来的目录结构逐文件看明白，才知道以后该改哪里。