配置文件
我们强烈建议使用专用的uno.config.ts
文件来配置您的UnoCSS,以便获得IDE和其他集成的最佳体验。
一个完整的配置文件如下所示:
ts
// 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或其他工具配置中的内联配置相比,专用配置文件将更好地与IDEs和集成以及ESLint插件等其他工具配合使用,此外还能使HMR更好地工作。
默认情况下,UnoCSS将自动查找uno.config.{js,ts,mjs,mts}
或`unocss.config.{js,ts,mjs,mts}``在项目的根目录中。您也可以手动指定配置文件,例如在Vite中:
ts
// vite.config.ts
import { defineConfig } from 'vite'
import UnoCSS from 'unocss/vite'
export default defineConfig({
plugins: [
UnoCSS({
configFile: '../my-uno.config.ts',
}),
],
})
有关支持的配置选项的完整列表,请参阅配置参考。