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

创建项目

使 Tauri 如此灵活的一个方面是它能够与几乎任何前端框架一起工作。我们创建了 create-tauri-app 实用程序，以帮助您使用官方维护的框架模板之一创建一个新的 Tauri 项目。

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

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

使用 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 单独初始化项目的后端。

  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 是 http://localhost: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? http://localhost: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 项目！🚀

下一步

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