跳到内容
Tauri
指南 参考 博客 发布

创建项目

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

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

或者，您可以将 Tauri 添加到现有项目中，以快速将现有的代码库转换为 Tauri 应用程序。

使用 create-tauri-app

标题为“使用 create-tauri-app”的章节

要开始使用 create-tauri-app，请在您想要设置项目的文件夹中运行以下命令之一。如果您不确定使用哪个命令，我们建议在 Linux 和 macOS 上使用 Bash 命令，在 Windows 上使用 PowerShell 命令。

sh <(curl https://create.tauri.app/sh)

按照提示操作，选择您的项目名称、前端语言、包管理器以及前端框架，如果适用，还需选择前端框架选项。

搭建新项目

标题为“搭建新项目”的章节

  1. 选择名称和包标识符（应用程序的唯一 ID）

    ? Project name (tauri-app) ›
    ? Identifier (com.tauri-app.app) ›

  2. 为您的前端选择一种风格。首先选择语言

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

  3. 选择包管理器（如果有多个可用）

    TypeScript / JavaScript 的选项

    ? Choose your package manager ›
    pnpm
    yarn
    npm
    bun

  4. 选择 UI 模板和风格（如果有多个可用）

    Rust 的选项

    ? Choose your UI template ›
    Vanilla
    Yew
    Leptos
    Sycamore

    TypeScript / JavaScript 的选项

    ? Choose your UI template ›
    Vanilla
    Vue
    Svelte
    React
    Solid
    Angular
    Preact
    

    ? Choose your UI flavor ›
    TypeScript
    JavaScript

    .NET 的选项

    ? Choose your UI template ›
    Blazor  (https://dotnet.microsoft.com/en-us/apps/aspnet/web-apps/blazor/)

完成后，该工具会报告模板已创建，并显示如何使用配置的包管理器运行它。如果它检测到您系统中缺少依赖项，它会打印出包列表并提示如何安装它们。

启动开发服务器

标题为“启动开发服务器”的章节

create-tauri-app 完成后，您可以导航到项目文件夹，安装依赖项，然后使用 Tauri CLI 启动开发服务器

cd tauri-app
npm install
npm run tauri dev

现在您会看到一个新窗口打开，您的应用程序正在运行。

恭喜！ 您已经创建了您的 Tauri 应用程序！ 🚀

手动设置 (Tauri CLI)

标题为“手动设置 (Tauri CLI)”的章节

如果您已经有现有的前端，或者更喜欢自己设置，可以使用 Tauri CLI 单独初始化项目的后端。

  1. 为您的项目创建一个新目录并初始化前端。您可以使用纯 HTML、CSS 和 JavaScript，或者您喜欢的任何框架，例如 Next.js、Nuxt、Svelte、Yew 或 Leptos。您只需要一种在浏览器中提供应用程序服务的方法。举个例子，这就是您设置简单 Vite 应用程序的方法

    mkdir tauri-app
    cd tauri-app
    npm create vite@latest .

  2. 然后，使用您选择的包管理器安装 Tauri 的 CLI 工具。如果您使用 cargo 安装 Tauri CLI，则必须全局安装它。

    npm install -D @tauri-apps/cli@latest

  3. 确定前端开发服务器的 URL。这是 Tauri 将用于加载您内容的 URL。例如，如果您使用 Vite，默认 URL 是 https://:5173。

  4. 在您的项目目录中，初始化 Tauri

    npx tauri init

    运行该命令后，它将显示一个提示，要求您选择不同的选项

    ✔ What is your app name? tauri-app
    ✔ What should the window title be? tauri-app
    ✔ Where are your web assets located? ..
    ✔ What is the url of your dev server? https://:5173
    ✔ What is your frontend dev command? pnpm run dev
    ✔ What is your frontend build command? pnpm run build

    这将在您的项目中创建一个 src-tauri 目录，其中包含必要的 Tauri 配置文件。

  5. 通过运行开发服务器来验证您的 Tauri 应用程序是否正常工作

    npx tauri dev

    此命令将编译 Rust 代码并打开一个包含您 Web 内容的窗口。

恭喜！ 您已经使用 Tauri CLI 创建了一个新的 Tauri 项目！ 🚀

下一步

名为“后续步骤”的章节
在 Open Collective 上支持 在 GitHub 上赞助

© 2026 Tauri 贡献者。CC-BY / MIT