跳到内容
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

标题为“Using create-tauri-app”的部分

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

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

按照提示选择项目名称、前端语言、包管理器以及前端框架（如果适用）和前端框架选项。

搭建新项目

标题为“Scaffold a new project”的部分

  1. 选择一个名称和一个 bundle 标识符（应用的唯一 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/)

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

启动开发服务器

标题为“Start the development server”的部分

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

cd tauri-app
npm install
npm run tauri dev

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

恭喜！ 你已成功创建 Tauri 应用！🚀

手动设置（Tauri CLI）

标题为“Manual Setup (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 项目！🚀

下一步

标题为“Next Steps”的部分
在 Open Collective 上支持 在 GitHub 上赞助

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