Skip to content

配置文件

我们强烈建议使用专用的 uno.config.ts 文件来配置你的 UnoCSS,以便在 IDE 和其他集成方面获得最佳体验。

一个功能齐全的配置文件如下所示:

uno.config.ts
ts
import {
  ,
  ,
  ,
  ,
  ,
  ,
  ,
  
} from 'unocss'

export default ({
  : [
    // ...
  ],
  : {
    : {
      // ...
    }
  },
  : [
    (),
    (),
    (),
    (),
    ({
      : {
        // ...
      },
    }),
  ],
  : [
    (),
    (),
  ],
})

与您在 vite.config.ts 或其他工具配置中使用的内联配置相比,专用配置文件将更好地与IDEs和集成工具(例如ESLint 插件)配合使用,并且使热模块替换(HMR)工作得更好。

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

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

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

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