配置文件

我们 强烈建议使用专用的“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 plugin）工作和集成，此外还使 HMR 工作得更好。

默认情况下，UnoCSS 会自动在项目的根目录中查找 uno.config.{js,ts,mjs,mts} 或 unocss.config.{js,ts,mjs,mts}。您也可以在 Vite 中手动指定配置文件，例如：

// vite.config.ts
import { defineConfig } from 'vite'
import UnoCSS from 'unocss/vite'

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

有关支持的配置选项的完整列表，请参阅配置参考。

配置文件 ​

配置文件