跳到內容
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. 選擇名稱和套件識別碼（您應用程式的 unique-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 Contributors. CC-BY / MIT