跳到主要內容
Tauri

Vite

Vite 是一個建置工具,旨在為現代 Web 專案提供更快、更精簡的開發體驗。本指南適用於 Vite 5.4.8 版本。

檢查清單

  • tauri.conf.json 中使用 dist/ 作為 frontendDist
  • 當設定在 iOS 實體裝置上運行時,使用 process.env.TAURI_DEV_HOST 作為開發伺服器主機 IP。

範例設定

  1. 假設您的 package.json 中有以下 devbuild 腳本

    {
    "scripts": {
    "dev": "vite dev",
    "build": "vite build"
    }
    }

    您可以設定 Tauri CLI 以使用您的 Vite 開發伺服器和 dist 資料夾,以及自動運行 Vite 腳本的 hooks

    tauri.conf.json
    {
    "build": {
    "beforeDevCommand": "npm run dev",
    "beforeBuildCommand": "npm run build",
    "devUrl": "http://localhost:5173",
    "frontendDist": "../dist"
    }
    }
  2. 更新 Vite 設定
    vite.config.js
    import { defineConfig } from 'vite';
    const host = process.env.TAURI_DEV_HOST;
    export default defineConfig({
    // prevent vite from obscuring rust errors
    clearScreen: false,
    server: {
    // Tauri expects a fixed port, fail if that port is not available
    strictPort: true,
    // if the host Tauri is expecting is set, use it
    host: host || false,
    port: 5173,
    },
    // Env variables starting with the item of `envPrefix` will be exposed in tauri's source code through `import.meta.env`.
    envPrefix: ['VITE_', 'TAURI_ENV_*'],
    build: {
    // Tauri uses Chromium on Windows and WebKit on macOS and Linux
    target:
    process.env.TAURI_ENV_PLATFORM == 'windows'
    ? 'chrome105'
    : 'safari13',
    // don't minify for debug builds
    minify: !process.env.TAURI_ENV_DEBUG ? 'esbuild' : false,
    // produce sourcemaps for debug builds
    sourcemap: !!process.env.TAURI_ENV_DEBUG,
    },
    });

© 2025 Tauri Contributors。CC-BY / MIT 授權條款