設定檔

我們**強烈建議您使用專用的 uno.config.ts 檔案**來設定您的 UnoCSS，以便在 IDE 和其他整合中獲得最佳體驗。

一個功能齊全的設定檔如下所示

uno.config.ts

import {
  defineConfig,
  presetAttributify,
  presetIcons,
  presetTypography,
  presetUno,
  presetWebFonts,
  transformerDirectives,
  transformerVariantGroup
} from 'unocss'

export default defineConfig({
  shortcuts: [
    // ...
  ],
  theme: {
    colors: {
      // ...
    }
  },
  presets: [
    presetUno(),
    presetAttributify(),
    presetIcons(),
    presetTypography(),
    presetWebFonts({
      fonts: {
        // ...
      },
    }),
  ],
  transformers: [
    transformerDirectives(),
    transformerVariantGroup(),
  ],
})

與在 vite.config.ts 或其他工具設定檔中的內嵌設定相比，專用的設定檔可以更好地與 IDE 和整合工具（例如 ESLint 外掛程式）配合使用，此外還能讓 HMR 更好地運作。

預設情況下，UnoCSS 會在專案的根目錄中自動搜尋 uno.config.{js,ts,mjs,mts} 或 unocss.config.{js,ts,mjs,mts}。您也可以手動指定設定檔，例如在 Vite 中

vite.config.ts

import UnoCSS from 'unocss/vite'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    UnoCSS({
      configFile: '../my-uno.config.ts',
    }),
  ],
})

如需支援的設定選項的完整清單，請參閱 設定參考。