unocss

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
UnoCSS is an instant atomic CSS engine designed to be flexible and extensible. The core is un-opinionated - all CSS utilities are provided via presets. It's a superset of Tailwind CSS, so you can reuse your Tailwind knowledge for basic syntax usage.
Important: Before writing UnoCSS code, agents should check for
uno.config.*
or
unocss.config.*
files in the project root to understand what presets, rules, and shortcuts are available. If the project setup is unclear, avoid using attributify mode and other advanced features - stick to basic
class
usage.
The skill is based on UnoCSS 66.x, generated at 2026-01-28.
UnoCSS 是一款即时原子化CSS引擎,设计灵活且可扩展。其核心不带有主观预设——所有CSS工具类均通过预设提供。它是Tailwind CSS的超集,因此你可以复用已有的Tailwind知识来使用基础语法。
重要提示: 在编写UnoCSS代码之前,开发人员应检查项目根目录下的
uno.config.*
unocss.config.*
文件,以了解可用的预设、规则和快捷方式。如果项目配置不明确,请避免使用属性化模式等高级功能——坚持使用基础的
class
用法。
本技能基于 UnoCSS 66.x 版本,生成于 2026-01-28。

Core

核心功能

TopicDescriptionReference
ConfigurationConfig file setup and all configuration optionscore-config
RulesStatic and dynamic rules for generating CSS utilitiescore-rules
ShortcutsCombine multiple rules into single shorthandscore-shortcuts
ThemeTheming system for colors, breakpoints, and design tokenscore-theme
VariantsApply variations like hover:, dark:, responsive to rulescore-variants
ExtractingHow UnoCSS extracts utilities from source codecore-extracting
Safelist & BlocklistForce include or exclude specific utilitiescore-safelist
Layers & PreflightsCSS layer ordering and raw CSS injectioncore-layers
主题描述参考文档
配置配置文件设置及所有配置选项core-config
规则用于生成CSS工具类的静态和动态规则core-rules
快捷方式将多个规则组合为单个简写形式core-shortcuts
主题用于颜色、断点和设计令牌的主题系统core-theme
变体为规则应用hover:、dark:、响应式等变体core-variants
提取UnoCSS如何从源代码中提取工具类core-extracting
安全列表与阻止列表强制包含或排除特定工具类core-safelist
层级与预定义样式CSS层级排序和原始CSS注入core-layers

Presets

预设

Main Presets

主要预设

TopicDescriptionReference
Preset Wind3Tailwind CSS v3 / Windi CSS compatible preset (most common)preset-wind3
Preset Wind4Tailwind CSS v4 compatible preset with modern CSS featurespreset-wind4
Preset MiniMinimal preset with essential utilities for custom buildspreset-mini
主题描述参考文档
Preset Wind3兼容Tailwind CSS v3 / Windi CSS的预设(最常用)preset-wind3
Preset Wind4兼容Tailwind CSS v4的预设,支持现代CSS特性preset-wind4
Preset Mini包含基础工具类的极简预设,适用于自定义构建preset-mini

Feature Presets

功能预设

TopicDescriptionReference
Preset IconsPure CSS icons using Iconify with any icon setpreset-icons
Preset AttributifyGroup utilities in HTML attributes instead of classpreset-attributify
Preset TypographyProse classes for typographic defaultspreset-typography
Preset Web FontsEasy Google Fonts and other web fonts integrationpreset-web-fonts
Preset TagifyUse utilities as HTML tag namespreset-tagify
Preset Rem to PxConvert rem units to px for utilitiespreset-rem-to-px
主题描述参考文档
Preset Icons使用Iconify的纯CSS图标,支持任何图标集preset-icons
Preset Attributify在HTML属性中分组工具类,替代class属性preset-attributify
Preset Typography用于排版默认样式的散文类preset-typography
Preset Web Fonts轻松集成Google Fonts及其他网络字体preset-web-fonts
Preset Tagify将工具类用作HTML标签名称preset-tagify
Preset Rem to Px将工具类中的rem单位转换为pxpreset-rem-to-px

Transformers

转换器

TopicDescriptionReference
Variant GroupShorthand for grouping utilities with common prefixestransformer-variant-group
DirectivesCSS directives: @apply, @screen, theme(), icon()transformer-directives
Compile ClassCompile multiple classes into one hashed classtransformer-compile-class
Attributify JSXSupport valueless attributify in JSX/TSXtransformer-attributify-jsx
主题描述参考文档
Variant Group为带有共同前缀的工具类提供简写形式transformer-variant-group
DirectivesCSS指令:@apply、@screen、theme()、icon()transformer-directives
Compile Class将多个类编译为单个哈希类transformer-compile-class
Attributify JSX在JSX/TSX中支持无值属性化transformer-attributify-jsx

Integrations

集成

TopicDescriptionReference
Vite IntegrationSetting up UnoCSS with Vite and framework-specific tipsintegrations-vite
Nuxt IntegrationUnoCSS module for Nuxt applicationsintegrations-nuxt
主题描述参考文档
Vite Integration配置UnoCSS与Vite集成及框架特定提示integrations-vite
Nuxt Integration用于Nuxt应用的UnoCSS模块integrations-nuxt