跳转到内容
Tauri
Guides References Blog Releases

创建项目

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

Section titled “使用 create-tauri-app”

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

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

按照提示操作，选择你的项目名称、前端语言、包管理器、前端框架，以及前端框架的相关选项（如适用）。

搭建一个新项目

Section titled “搭建一个新项目”

  1. 选择一个名称和一个包标识符（你应用的唯一标识符）：

    ? 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/)

一旦完成, 该实用程序会报告模板已创建，并显示如何使用配置的包管理器运行它。如果它检测到你的系统上缺少依赖项，它会打印出包列表，并提示如何安装它。

启动开发服务器

Section titled “启动开发服务器”

在 create-tauri-app 执行完成后，你可以进入项目文件夹，安装依赖，然后使用 Tauri CLI 启动开发服务器：

cd tauri-app
npm install
npm run tauri dev

现在你会看到一个新窗口打开，其中正在运行你的应用。

恭喜！ 你已经制作出了你的 Tauri 应用！🚀

手动设置 (Tauri CLI)

Section titled “手动设置 (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 用来加载你应用内容的地址。例如，如果你使用的是 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 代码，并打开一个窗口来显示你的网页内容。

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

下一步

Section titled “下一步”
Support on Open Collective Sponsor on GitHub

© 2026 Tauri Contributors. CC-BY / MIT