我所理解的 UnoCSS 最佳实践(7):利用 Lint 规范写法
工具类写进 @apply,模板留下元素职责
卡片有标题、内容区和紧凑状态。读模板时,我想先看到这几件事,间距、字号和背景则去样式里找。因此这组实践约定,能生成视觉声明的 UnoCSS 工具类写在 CSS 的 @apply 里,模板用语义类名表达元素和状态。这里的 CSS 也包括 Vue 的 <style scoped lang="scss">。
<template>
<article class="resource-card" :class="{ 'resource-card--compact': compact }">
<h2 class="resource-card__title">{{ title }}</h2>
</article>
</template>
<style scoped lang="scss">
.resource-card {
@apply gap-12px grid p-16px;
&--compact {
@apply p-8px;
}
&__title {
@apply text-20px;
}
}
</style>
已经采用模板工具类的项目可以继续沿用那套写法。group、peer 这类标记要另看,它们参与 DOM 选择器关系,@apply 无法给元素添加 class。模板若只保留语义类,可以把对应关系写成 CSS 选择器。组件库要求的固定类名和作为公共接口的样式 hook 也按原契约保留。第三篇的 DOM 标记与样式分工
把检查放到写法出现的位置
模板里的 class="flex p-4" 或 :class="compact ? 'p-2' : 'p-4'" 适合由 ESLint 检查。@sheng/ui-no-unocss-class-in-template 在 Vue 模板和 JSX / TSX 中提取静态候选,用项目的 uno.config.ts 识别预设、自定义规则、shortcut 和变体。普通语义类直接通过,和工具类重名的第三方类可以精确放行。无法静态判断的动态表达式可由 checkDynamicClass 报告,迁到样式前仍需人工确定语义类和状态条件。接入和例外选项见模板规则文档。
vue/no-restricted-class 和 better-unocss/no-restricted-classes 都适合维护明确的禁用名单。项目加一个新的 shortcut 时,名单还得跟着补。UnoCSS 官方的 blocklist 又是构建配置的一部分,名单里的工具类也可能在 @apply 中失效。用 UnoCSS 66.11.0 验证时,把 flex 加进去,.resource-card { @apply flex p-4; } 就只剩下 padding: 1rem。模板要限制的是工具类的使用位置,工具本身还要继续生成样式。第三篇的模板诊断与构建对照
到了 <style>,同一段 .resource-card { @apply grid p-4; } 在 vue-eslint-parser 的文档树里是 VText,而在 postcss-html 提供的样式树里已经有 name: 'apply'、params: 'grid p-4' 的 at-rule 节点。官方 unocss/order 遍历模板和脚本中的类串,它没有这个 CSS 入口。项目已经用 Stylelint 和 postcss-html 检查 Vue 样式块,规则可以直接从 at-rule 节点读参数。两个入口分别见 Vue parser 的文档树和 Stylelint 自定义语法。
为什么 @poupe 可以用 ESLint 检查 @apply
ESLint 可以通过 language plugin 处理 CSS。@eslint/css 提供 css/css 语言和 CSS AST,@poupe/eslint-plugin-tailwindcss 在此基础上注册 tailwindcss/css,用 tailwind-csstree 扩展 Tailwind v4 的指令语法。它的规则访问 CSS 的 Atrule,遇到 @apply 就读取参数。默认预设匹配 .css / .postcss。要检查 Vue <style>,还得把样式块提取出来并送给 CSS 语言入口。语法和文件范围分别见 ESLint 的 CSS 语法扩展和 @poupe 的默认配置。
CSS parser 负责找出 @apply,识别 p-4 写入哪些属性则是规则的工作。@poupe 按内置模式分组,Tailwind IntelliSense 会查询 Tailwind 的设计系统,再比较生成的声明和选择器上下文。这两种判断分别见 @poupe 的规则实现和 Tailwind 的冲突诊断实现。
UnoCSS 的 ESLint 插件检查哪些写法
@unocss/eslint-plugin 导出四条规则。@unocss/eslint-config/flat 默认把前两条开成 warn,其余按需开启。具体见官方规则文档和 v66.12.0 的默认配置。
| 规则 | 检查内容 |
|---|---|
unocss/order |
排序 class 字符串,也处理选定的函数、变量,以及带前缀的 Attributify 属性值。 |
unocss/order-attributify |
排序 Vue 模板中的无值属性,例如 <div p-4 flex /> 里的两个属性。 |
unocss/blocklist |
用 uno.config.ts 的 blocklist 对静态类名等输入报告诊断。 |
unocss/enforce-class-compile |
要求 Vue 的类串带 :uno: 标记,由 transformerCompileClass() 在构建时合成生成类。 |
eslint-plugin-better-unocss 0.5.0 覆盖的类串位置更多,包括一些工具函数、tagged template 和 Vue 动态绑定。它的 recommended 把四条格式检查设为 warn,把未知类和冲突设为 error。禁用名单需要单独配置,见 v0.5.0 的规则与预设。
| 规则 | 检查内容 |
|---|---|
better-unocss/order |
按项目的 UnoCSS 配置计算类名顺序。 |
better-unocss/no-duplicate-classes |
在同一段字面量里查 p-2 p-2 这类完全相同的 token。 |
better-unocss/no-unnecessary-whitespace |
整理类串的首尾空白和连续空格,默认跳过已有的多行类串。 |
better-unocss/enforce-line-wrapping |
按行宽、每行类数和变体分组检查换行。 |
better-unocss/no-restricted-classes |
按配置中的正则禁用类名,可以附提示和替换。 |
better-unocss/no-unknown-classes |
询问 UnoCSS 引擎是否认识工具类。合法的 BEM 或组件库类名可能需要 ignore。 |
better-unocss/no-conflicting-classes |
比较工具类生成的属性集合与上下文,报告 p-2 p-4 这类冲突,并提供删类修复。 |
比如项目加了一个 shortcut,no-unknown-classes 已经认识它,no-restricted-classes 仍需等你补禁用模式。判断一个类能不能生成样式和判断它有没有命中禁用名单,各走各的逻辑,分别见未知类规则和禁用规则。
样式层已经实现的 Stylelint 规则
模板工具类由 ESLint 禁用后,样式里的工作变成检查声明、媒体条件和 @apply 参数。项目把这部分规则放在 @sheng/stylelint-plugin 的 unocss-apply 分组。
| 规则 | 在样式层检查什么 |
|---|---|
sheng/apply-no-invalid-utilities |
按项目编译器报告无法生成样式的静态候选。 |
sheng/unocss-no-duplicate-apply-utilities |
检查同一源码选择器块里重复的工具类,覆盖多条同级 @apply。 |
sheng/apply-no-conflicting-utilities |
检查同一条件下不同候选写入的属性重叠,包括简写覆盖子属性。 |
sheng/no-order-dependent-declarations |
检查同一源码块中普通 CSS 声明的顺序依赖。 |
sheng/unocss-no-unreachable-apply-variants |
报告生成的视口宽度上下限互相矛盾的工具类。 |
sheng/unocss-prefer-apply |
提示把普通视觉声明放进 @apply,保留自定义属性定义、描述符和适用的动态声明。 |
sheng/unocss-prefer-css-var-shorthand |
已知无歧义的单变量引用优先用 $ 简写,复合值和类型提示按原语法处理。 |
sheng/unocss-prefer-equivalent-utility |
显式选用 Wind4 后,提示缩短部分任意属性和任意值。 |
sheng/unocss-prefer-responsive-variants |
对项目已知的断点和支持的媒体条件提示就近使用变体。 |
sheng/unocss-prefer-variant-groups |
每个源码样式块用一条 @apply,基础工具类在前,相同条件合组。 |
sheng/unocss-apply-order |
检查可安全排序的基础参数区及各条件组内的工具类字典序。 |
博客主题通过 configPath 使用真实的 uno.config.ts。@apply p-2 p-4 和分开写的 @apply p-2; @apply p-4; 都会标出 p-4。p-2 与 md:p-4 的生成条件不同,可以共存。主题把 sm 配为 576px、md 配为 768px,因此 lt-sm:md:(p-4) 会报告空区间。冲突规则与配置 · 为什么用 Stylelint 检查样式
变体分组规则要求一个源码样式块只写一条 @apply。基础工具类和条件组优先同排,超过行宽再续行。嵌套选择器和原生媒体块分别检查。
用 Stylelint 减少多余的方括号
在 stylelint.config.mjs 的 rules 中启用 sheng/unocss-prefer-equivalent-utility: [true, { preset: 'wind4' }],可以同时检查 [min-inline-size:0] 和 w-[50%] 这两种形态,分别建议 min-inline-0px 和 w-50%。再启用 sheng/unocss-prefer-css-var-shorthand: true,把 [min-block-size:var(--height)] 缩成 min-block-$height。这两条规则要随已注册的 @sheng/stylelint-plugin 使用。
p-[2px_8px] 要保留两个物理方向的内边距值,[background:var(--surface)] 要保留简写的重置范围,这些方括号都有实际用途。项目定义了同名工具类时,用 sheng/apply-no-invalid-utilities 核对候选能否生成,再看实际构建的声明是否等价。UnoCSS 的 blocklist 也能限制某些拼写,但它会让匹配的候选停止生成样式。只做写法迁移时,Stylelint 的诊断更容易逐处处理。
为什么读取 uno.config.ts
PostCSS 能读到 @apply 的参数,却不知道一个工具类会生成什么。规则通过 @unocss/config 加载项目导出的配置,再把它交给 @unocss/core 创建生成器。预设、主题、自定义规则、shortcut、变体和生成禁用名单一起决定候选是否有效、写出哪些声明、受哪些条件限制,以及匹配哪个规则索引。比如博客使用 Wind4,lt-sm: 的上界来自主题的 576px 断点。重复候选与单指令排版只需要源码结构,可以直接检查。
用各项目的编译器判断候选
sheng/apply-no-invalid-utilities 和 sheng/apply-no-conflicting-utilities 共用候选位置与冲突判断。UnoCSS 用项目生成器展开变体组。Tailwind v3 的 @apply 使用项目的 PostCSS 编译器与 JS 配置,也能识别同一处理单元的自定义类。v4 用 Node 编译器解析样式块自身的 @import 和 @reference,因此两个分别编译的 Vue 样式块可以看到不同的工具类。默认 Tailwind 中的裸 ease 会被报告,项目定义了同名工具类时可以通过。
const compiler = { engine: 'tailwind-v4' };
export default {
plugins: ['@sheng/stylelint-plugin'],
rules: {
'sheng/apply-no-invalid-utilities': [true, compiler],
'sheng/apply-no-conflicting-utilities': [true, compiler],
'sheng/no-order-dependent-declarations': true,
},
};
在项目的 Stylelint 配置中选择编译器,可用值为 unocss、tailwind-v3 或 tailwind-v4。UnoCSS 和 Tailwind v3 可用 configPath 指向配置。Tailwind v4 仍由 CSS 自己声明引用。Lint 能看到的是各自的静态样式块,框架注入、Sass 执行和其他 PostCSS 插件参与的样式,仍要用项目构建验证。
排序和发现冲突分开做
原生 CSS 可以让 stylelint-order 管排列,再用 Stylelint 的重复声明、简写覆盖规则指出可能有问题的块。@apply 中看到的还是工具类。p-2 p-2 只需比较 token,p-2 p-4 要知道两边都会写 padding。p-2 md:p-4 则应允许,后者只在断点条件成立时覆盖基础样式。第三篇的属性顺序实验 · Stylelint 的简写覆盖规则
模板类串的排序也要考虑 JS 怎样使用结果。用 @unocss/eslint-plugin 66.12.0 跑 --fix,const className = `px-4 bg-${color}` 被改成 const className = `bg- px-4${color}` 。排序也会改变 twMerge() 的返回值。把 twMerge('p-4 p-2') 赋给 className 后,修复将参数改成 'p-2 p-4',保留的类就从 p-2 变为 p-4。用 better-unocss/order 0.5.0 跑,插值会被拆坏,连单独调用 twMerge() 的字面量也会被排。官方仓库的 讨论 #5411 也记录了插值贴着类名时的误改。完整官方排序样本见UnoCSS 排序复现弹窗。
@poupe 0.3.1 能报出 @apply p-4 p-2 的冲突,--fix 却保留了源码最后的 p-2,这是它的删类逻辑决定的。Tailwind CSS 4.3.5 实际先生成 p-2 再生成 p-4 的声明。在 --spacing: 0.25rem 的复现配置下,修复把最终内边距从 1rem 改成了 0.5rem。我用 Tailwind 官方语言服务 0.16.0 验证了相同冲突在 .css 和 Vue <style> 中都能报告。两种工具在这个样本中都不会把两条独立 @apply 当成同一份类串,具体诊断见工具实测记录弹窗。
apply-no-conflicting-utilities 对照生成的选择器、外层条件和属性。p-2 p-4 在 UnoCSS、Tailwind v3 和 v4 都写入 padding,所以三个入口都能报告。[border:0] [border-top:1px_solid_red] 也会命中,因为简写已经写了顶边。同一源码块混用普通声明和基础候选时也会比较。原生声明由 no-order-dependent-declarations 检查两个书写方向。不同媒体条件之间的覆盖、跨选择器的层叠和浏览器回退仍需结合场景验证。
两个生态的工具入口
Tailwind CSS 的选择主要多在入口上。同一个冲突可以由模板 ESLint 规则检查,也可以由语言服务在编辑器提示,或者交给复用语言服务的 CLI。选工具时先看它读取的是模板、@apply、配置入口,还是编译后的 CSS。
候选是否合法、同块是否有重复或冲突、变体能否生效,以及 @apply 怎样组织和排序,都有对应的检查。逐条对照后,剩余规则主要依赖另一套约定,例如在模板写工具类、使用 Attributify、限制设计刻度,或维护 Tailwind 入口。!important 由具体的层叠需求决定,例如打印样式要覆盖图片已有的滤镜。每项检查的适用条件见UnoCSS 与 Tailwind CSS 的逐条规则对照弹窗。
| 工具 | 能检查或处理的位置 |
|---|---|
| Tailwind CSS IntelliSense | 官方语言服务。cssConflict 检查类串和 @apply,invalidApply 是另一项诊断。 |
eslint-plugin-tailwindcss 与 eslint-plugin-better-tailwindcss |
模板与脚本里的类名检查。前者有 no-contradicting-classname,后者有 no-conflicting-classes、no-duplicate-classes 等。接入时按 Tailwind 版本选择相应版本或配置入口。 |
@dayflower/tw-lint 与 tinyfroggy/twlint |
社区 CLI。前者复用 Tailwind 语言工具,后者也提供 ESLint / Oxlint 规则入口。 |
@poupe/eslint-plugin-tailwindcss |
用 ESLint 的 CSS 语言检查 Tailwind v4 的指令和部分工具类冲突。 |
stylelint-plugin-tailwindcss |
同一个包分别提供 tailwindcss/* 和 unocss/*。unocss/no-invalid-apply 会用 UnoCSS 引擎核对疑似工具类的未知候选,同时放过形似语义名的 token。这个检查适合补拼写诊断,已知工具类之间的冲突是另一项职责。 |
| UnoCSS LSP 与 UnoCSS 官方 ESLint 插件 | UnoCSS 的编辑器语言服务和模板类串检查。若已有 Oxlint 的 JS 插件接入,也可以加载官方 ESLint 插件,仍按该入口支持的文件范围检查。 |
排序格式化还有 Tailwind 官方的 prettier-plugin-tailwindcss,UnoCSS 社区有 prettier-plugin-unocss。它们解决的是排版,是否有未知类、冲突或错误的覆盖关系,仍要看对应的诊断和编译结果。
stylelint-plugin-tailwindcss 的完整预设包含 unocss/no-apply 和 unocss/no-variant-group,会禁止本系列采用的写法。单独注册 unocssNoInvalidApplyPlugin 时,3.2.2 能报 bg-rd-500,放过形似语义类的 button-base,也放过 flxe 和 hover:(p-2 bg-rd-500)。主题用自研规则逐个核对静态候选,并把位置指到原文件中的组内工具类。
Tailwind 的规则能复用到 UnoCSS 吗
可以复用只看通用 CSS 的规则,例如重复声明、选择器结构和属性顺序。纯文本的完全重复检查也容易移植,前提是能按 UnoCSS 语法切出完整 token。遇到 hover:(p-2 p-4) 这样的分组时,按空格直接切会把一个组拆碎。
用 UnoCSS 66.12.0 和 Tailwind CSS 4.3.5 的默认主题比较,甚至同名类也会给出不同的属性。下面的输出来自同一批工具类的编译对照弹窗。
| 候选 | UnoCSS Wind3 / Wind4 | Tailwind CSS v4 |
|---|---|---|
p-16px |
两者都生成 padding: 16px。 |
默认主题下无匹配。 |
text-$card-text |
两者都生成 color: var(--card-text)。 |
默认主题下无匹配。 |
lt-sm:p-4 |
两者都生成小于 sm 时生效的样式。 |
默认主题下无匹配。 |
px-4 |
Wind3 写 padding-left、padding-right,Wind4 写 padding-inline。 |
写 padding-inline。 |
直接让 Tailwind 的未知类检查跑在 UnoCSS 源码上,可能把前三种合法写法报成未知。即使两个引擎都认识 px-4,用错引擎也会让属性冲突判断偏离真实构建。可共享的是提取位置、诊断方式和规则思路,识别工具类、解析变体和比较声明时要接当前项目的引擎。UnoCSS 的自定义规则 · 第四篇的兼容边界
对这套实践,模板 ESLint 回答「工具类有没有写错地方」,样式 Lint 回答「这里的写法是否符合项目约定」,编译验证再回答「它会生成什么,整理后会不会变」。这三个问题各有一个能拿到所需信息的入口。
UnoCSS 官方排序规则的复现
打开原文件 utility-order-report.json
{
"versions": {
"node": "26.12.0",
"eslint": "10.13.0",
"eslintPluginUnoCSS": "66.12.0",
"unoCSS": "66.12.0",
"tailwindMerge": "3.7.0"
},
"order": {
"preset": "wind3",
"interpolation": {
"input": "const className = `px-4 bg-${color}`",
"output": "const className = `bg- px-4${color}`",
"valueBefore": "px-4 bg-red",
"valueAfter": "bg- px-4red"
},
"merge": {
"input": "const className = twMerge('p-4 p-2')",
"output": "const className = twMerge('p-2 p-4')",
"valueBefore": "p-2",
"valueAfter": "p-4"
}
},
"directives": {
"preset": "wind4",
"apply": [
{
"input": ".resource-card { @apply p-16px grid gap-12px; }",
"css": ".resource-card { padding:16px;gap:12px;display:grid; }"
},
{
"input": ".resource-card { @apply grid gap-12px p-16px; }",
"css": ".resource-card { padding:16px;gap:12px;display:grid; }"
}
],
"separateApply": [
{
"input": ".resource-card { @apply p-16px; @apply pl-4px; }",
"css": ".resource-card { padding:16px; padding-left:4px; }"
},
{
"input": ".resource-card { @apply pl-4px; @apply p-16px; }",
"css": ".resource-card { padding-left:4px; padding:16px; }"
}
]
}
}Tailwind 冲突诊断与跨引擎编译实测
{
"crossEngine": {
"node": "26.12.1",
"versions": {
"unocss": "66.12.0",
"tailwindcss": "4.3.5",
"stylelint": "17.16.0",
"stylelint-plugin-tailwindcss": "3.2.2"
},
"compare": [
{
"token": "p-4",
"wind3": "/* layer: default */\n.p-4{padding:1rem;}",
"wind4": "/* layer: default */\n.p-4{padding:calc(var(--spacing) * 4);}",
"tailwind": ".p-4 {\n padding: calc(var(--spacing) * 4);\n}\n"
},
{
"token": "px-4",
"wind3": "/* layer: default */\n.px-4{padding-left:1rem;padding-right:1rem;}",
"wind4": "/* layer: default */\n.px-4{padding-inline:calc(var(--spacing) * 4);}",
"tailwind": ".px-4 {\n padding-inline: calc(var(--spacing) * 4);\n}\n"
},
{
"token": "p-16px",
"wind3": "/* layer: default */\n.p-16px{padding:16px;}",
"wind4": "/* layer: default */\n.p-16px{padding:16px;}",
"tailwind": null
},
{
"token": "text-$card-text",
"wind3": "/* layer: default */\n.text-\\$card-text{color:var(--card-text);}",
"wind4": "/* layer: default */\n.text-\\$card-text{color:var(--card-text);}",
"tailwind": null
},
{
"token": "lt-sm:p-4",
"wind3": "/* layer: default */\n@media (max-width: 639.9px){\n.lt-sm\\:p-4{padding:1rem;}\n}",
"wind4": "/* layer: default */\n@media (max-width: calc(40rem - 0.1px)){\n.lt-sm\\:p-4{padding:calc(var(--spacing) * 4);}\n}",
"tailwind": null
},
{
"token": "ease",
"wind3": "/* layer: default */\n.ease{transition-timing-function:cubic-bezier(0.4, 0, 0.2, 1);}",
"wind4": "/* layer: properties */\n@property --un-ease{syntax:\"*\";inherits:false;}\n/* layer: default */\n.ease{--un-ease:var(--ease-DEFAULT);transition-timing-function:var(--ease-DEFAULT);}",
"tailwind": null
}
],
"stylelintChecks": [
{
"input": "bg-rd-500",
"messages": [
{
"rule": "unocss/no-invalid-apply",
"text": "Unexpected invalid UnoCSS @apply candidate \"bg-rd-500\" (unocss/no-invalid-apply)"
}
]
},
{
"input": "button-base",
"messages": []
},
{
"input": "p-2 p-4",
"messages": []
},
{
"input": "p-16px",
"messages": []
}
]
},
"tailwindConflicts": {
"node": "26.12.1",
"tailwind": "4.3.5",
"languageService": "0.16.0",
"eslint": "9.39.5",
"poupe": "0.3.1",
"inputs": {
"conflict": "@apply p-4 p-2;",
"duplicate": "@apply p-2 p-2;",
"distinctConditions": "@apply p-2 md:p-4;",
"separateDirectives": "@apply p-2; @apply p-4;",
"shorthandWithLonghand": "@apply p-4 pt-2;",
"vue": "<div class=\"p-2 p-4\" /> and @apply p-2 p-4;"
},
"results": [
{
"name": "conflict",
"poupe": [
"Conflicting utilities: \"p-4\" and \"p-2\" both affect padding"
],
"fixed": ".box { @apply p-2; }",
"editor": [
"'p-4' applies the same CSS properties as 'p-2'.",
"'p-2' applies the same CSS properties as 'p-4'."
]
},
{
"tailwindVersion": "4.3.5",
"originalCSS": "/*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */\n:root, :host {\n --spacing: 0.25rem;\n}\n.box {\n padding: calc(var(--spacing) * 2);\n padding: calc(var(--spacing) * 4);\n}\n",
"fixedCSS": "/*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */\n:root, :host {\n --spacing: 0.25rem;\n}\n.box {\n padding: calc(var(--spacing) * 2);\n}\n"
},
{
"name": "duplicate",
"poupe": [
"Duplicate utility \"p-2\"",
"Conflicting utilities: \"p-2\" and \"p-2\" both affect padding"
],
"fixed": ".box { @apply p-2; }",
"editor": [
"'p-2' applies the same CSS properties as 'p-2'.",
"'p-2' applies the same CSS properties as 'p-2'."
]
},
{
"name": "distinct conditions",
"poupe": [],
"editor": []
},
{
"name": "separate directives",
"poupe": [],
"editor": []
},
{
"name": "shorthand with longhand",
"poupe": [],
"editor": []
},
{
"vue": [
{
"line": 0,
"message": "'p-2' applies the same CSS properties as 'p-4'."
},
{
"line": 0,
"message": "'p-4' applies the same CSS properties as 'p-2'."
},
{
"line": 1,
"message": "'p-2' applies the same CSS properties as 'p-4'."
},
{
"line": 1,
"message": "'p-4' applies the same CSS properties as 'p-2'."
}
]
}
]
}
}UnoCSS 与 Tailwind CSS 的逐条规则对照
按工具逐条列出检查对象,并对照博客采用的语义模板和单条多行 @apply。同一种诊断可能出现在多个工具里。取舍以当前项目的写法为准,例如未知候选和覆盖关系已经有检查,设计刻度和重要性限制则需要另有项目约定。
UnoCSS 官方 ESLint 66.12.0
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
order |
排序类串 | 借排序检查的思路,样式块采用独立字典序提示。 |
order-attributify |
排序 Attributify 属性 | 只适合采用 Attributify 的模板。 |
blocklist |
报告命中 UnoCSS 生成禁用名单的候选 | 要全项目禁止生成时可以直接配置。 |
enforce-class-compile |
要求类串使用编译类标记 | 用于主动采用 compile class 的项目。 |
better-unocss 0.5.0
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
order |
按 UnoCSS 引擎顺序排列类串 | 源码排序用本地的独立字典序检查。 |
no-duplicate-classes |
报告重复的类名 | 样式规则移植这个思路,并检查同块多条指令。 |
no-conflicting-classes |
报告同条件下设置相同属性的类 | 由样式侧的属性冲突规则覆盖。 |
no-unknown-classes |
校验候选是否由 UnoCSS 识别 | 由样式侧的无效候选规则覆盖。 |
no-restricted-classes |
限制匹配项目禁用模式的类 | 有具体迁移或设计约定时再加名单。 |
no-unnecessary-whitespace |
整理类串里多余的空白 | 交给 Prettier 的 apply 换行插件。 |
enforce-line-wrapping |
按行宽和分组策略折行 | 样式侧由 Prettier 按行宽续行。 |
stylelint-plugin-tailwindcss 3.2.2
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
unocss/no-atomic-class |
检查手写的工具类选择器 | 可单独启用,合法重名和第三方覆盖需要例外。 |
unocss/no-invalid-apply |
验证疑似 UnoCSS 工具类的候选 | 主题采用能深入分组并检查任意静态候选的自研规则。 |
unocss/no-apply |
禁用 UnoCSS 的 apply | 本系列用 apply 表达视觉样式。 |
unocss/no-arbitrary-value |
禁用 UnoCSS 任意值和任意属性 | 本系列用任意属性表达精确值和重置范围。 |
unocss/no-variant-group |
禁用 UnoCSS 变体组 | 本系列用分组集中相同条件。 |
tailwindcss/no-atomic-class |
检查手写的 Tailwind 工具类选择器 | UnoCSS 项目使用对应的 UnoCSS 规则。 |
tailwindcss/no-invalid-apply |
校验疑似 Tailwind 工具类的候选 | Tailwind 项目可直接使用。 |
tailwindcss/no-apply |
禁用 Tailwind apply | 是否允许 apply 由项目样式约定决定。 |
tailwindcss/no-arbitrary-value |
禁用 Tailwind 任意值和任意属性 | 适合明确限制任意值的设计系统。 |
tailwindcss/no-invalid-theme-function |
检查 Tailwind theme() 的路径 | 依赖 Tailwind 配置与主题数据。 |
tailwindcss/no-theme-function |
禁用 Tailwind theme() | 适合已选用其他主题引用方式的项目。 |
tailwindcss/no-screen-directive |
禁用 Tailwind screen 指令 | 用于特定 Tailwind 写法迁移。 |
tailwindcss/no-tailwind-directive |
禁用 Tailwind tailwind 指令 | 用于 Tailwind 入口迁移。 |
tailwindcss/no-import-directive |
限制 Tailwind 导入指令 | 由项目构建入口约定决定。 |
tailwindcss/no-css-layer |
禁用 layer 指令 | 涉及标准 CSS 层叠层,保持项目自己的策略。 |
eslint-plugin-tailwindcss 4.4.0
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
classnames-order |
按 Tailwind 的顺序排列工具类 | 样式侧使用独立字典序提示。 |
enforces-canonical-classname |
将候选换成 Tailwind 的规范形式 | UnoCSS 需根据自己的生成结果建立映射。 |
enforces-negative-arbitrary-values |
统一负数任意值的写法 | 语法依预设而异,先核对项目的惯用写法。 |
enforces-shorthand |
把多个工具类合并成简写 | 比较整个块的生成声明后再给建议。 |
important-modifier-suffix |
统一 important 后缀 | 预处理语法由构建验证,项目保留确有需要的写法。 |
no-arbitrary-value |
禁用任意值 | 保留本系列的合法任意值。 |
no-contradicting-classname |
查找互相冲突的工具类 | 由 UnoCSS 属性冲突规则覆盖样式侧。 |
no-custom-classname |
检查未被 Tailwind 识别的类 | 模板需要允许语义 BEM,样式侧只查 apply 候选。 |
no-unnecessary-arbitrary-value |
提示可用现成工具类代替的任意值 | 继续扩充已验证的 Wind4 等价映射。 |
better-tailwindcss 4.11.0
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
enforce-consistent-line-wrapping |
统一类串折行 | 样式侧由 Prettier 按行宽续行。 |
enforce-consistent-class-order |
统一工具类顺序 | 样式侧使用独立字典序提示。 |
enforce-consistent-variant-order |
统一多重变体的书写顺序 | 变体交换可能改变生成选择器,保留原条件链。 |
enforce-consistent-variable-syntax |
统一变量引用语法 | 已有 UnoCSS 美元变量简写。 |
enforce-consistent-important-position |
统一 important 标记位置 | 预处理语法由构建验证,项目保留确有需要的写法。 |
enforce-shorthand-classes |
提示可合并的工具类 | 只补生成结果确实等价的映射。 |
enforce-logical-properties |
偏好逻辑方向工具类 | 根据 RTL 与 writing-mode 需求配置。 |
enforce-canonical-classes |
提示 Tailwind 规范形式 | UnoCSS 使用自己的等价工具类规则。 |
no-duplicate-classes |
检查重复类名 | 同块重复由自研 Stylelint 规则覆盖。 |
no-deprecated-classes |
提示弃用类名 | 仅在已确认版本和迁移映射后启用。 |
no-unnecessary-whitespace |
检查类串多余空白 | 交给格式化。 |
no-concatenated-classes |
检查动态拼接的类串 | 模板 ESLint 已有严格动态检查。 |
no-unknown-classes |
检查 Tailwind 不认识的候选 | 样式侧使用 UnoCSS 生成器。 |
no-conflicting-classes |
查找生成属性的冲突 | 样式侧由自研规则覆盖。 |
no-restricted-classes |
按项目模式限制类名 | 只有明确禁止的场景才配置。 |
Tailwind 语言服务 0.16.0 与 CLI
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
cssConflict |
诊断候选写入的属性冲突 | 样式侧由 UnoCSS 冲突规则覆盖。 |
invalidApply |
诊断不支持的 apply 用法 | 借鉴在原文件指向失败候选的做法。 |
invalidScreen |
诊断未知的断点引用 | 当前主题用项目断点配置与 UnoCSS 变体。 |
invalidVariant |
诊断无效的变体引用 | 静态候选校验会覆盖生成器不识别的变体。 |
deprecatedAtRule |
提示弃用指令 | 按实际引擎版本做迁移。 |
invalidConfigPath |
诊断 theme 等配置路径 | 需要知道真实主题与函数的语法。 |
invalidTailwindDirective |
诊断 tailwind 指令的参数 | Tailwind 特有。 |
invalidSourceDirective |
诊断 source 指令的用法 | Tailwind 特有。 |
recommendedVariantOrder |
提示推荐的变体次序 | 保留会改变选择器的顺序。 |
usedBlocklistedClass |
提示使用了生成禁用名单里的类 | 需要禁用生成时直接用 UnoCSS 配置。 |
suggestCanonicalClasses |
提示等价的规范写法 | UnoCSS 维护经过验证的等价映射。 |
@dayflower/tw-lint 把同一套语言工具接到 CLI。twlinter 也复用其中部分诊断,另外增加的检查单列在后面。
twlinter 0.8.0
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
no-duplicate-utilities |
诊断重复的工具类 | 自研规则覆盖一条及多条 apply。 |
prefer-truncate-shorthand |
建议用 truncate 代替多个属性 | 结合现有截断规则,核对展开与行高。 |
no-important-abuse |
提示在一个类串里堆叠 important | 逐处判断覆盖需求,当前样式无数量门槛。 |
no-sr-only-display-conflict |
检查 sr-only 和 display 工具类组合 | 先看真实生成和可访问性,UnoCSS 的 block 不会撤销其他视觉隐藏声明。 |
consistent-negative-arbitrary-values |
统一任意值的负号位置 | 依赖目标预设的等价形式。 |
require-flex-for-flex-utilities |
提示 flex 方向或换行缺少 flex | 样式也可从其他规则获得 display,局部源码证据不足。 |
prefer-theme-scale |
建议改用主题的间距和字号刻度 | 只有与项目刻度等价时才提示。 |
no-magic-spacing |
限制不在固定间距刻度上的数值 | 保留设计稿需要的精确间距。 |
detect-conflicts-in-template-literals |
检查模板字符串各段中的重复工具类 | 模板由 ESLint 处理。 |
prefer-design-tokens |
建议用 token 代替硬编码颜色 | 适合已有语义色映射的项目。 |
no-raw-colors |
禁止直接使用调色板颜色 | 按设计系统策略决定。 |
no-unknown-classes |
诊断引擎无法生成的类并给建议 | 无效 apply 校验已覆盖基础诊断。 |
shorthand-classes |
依设计系统建议合并类串 | 需要 UnoCSS 自己的展开等价证明。 |
@poupe/eslint-plugin-tailwindcss 0.3.1
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
consistent-spacing |
统一 CSS 声明冒号旁的空白 | 交给现有格式化。 |
no-arbitrary-value-overuse |
提示过量使用任意值 | 项目确有设计 token 策略时再配置。 |
no-conflicting-utilities |
诊断候选生成属性的冲突 | 样式侧使用自研 UnoCSS 规则。 |
no-duplicate-imports |
查找重复的 CSS 导入 | 直接用通用 CSS 规则。 |
no-duplicate-reference |
查找重复的 reference 指令 | Tailwind 特有。 |
no-empty-blocks |
查找空样式块 | 直接用 Stylelint block-no-empty。 |
no-important |
限制 important | 打印等必要覆盖保留 !important,具体优先级由层叠决定。 |
no-invalid-at-rules |
检查指令名与用法 | 普通 CSS 部分可直接启用 Stylelint,框架指令按实际语法配置。 |
no-invalid-named-grid-areas |
检查 grid 区域定义 | 普通声明可用 Stylelint 内建检查。 |
no-invalid-properties |
检查属性名 | 普通 CSS 可用 Stylelint 内建检查。 |
prefer-logical-properties |
建议用逻辑方向属性 | 按项目 RTL 需求配置。 |
prefer-theme-tokens |
建议用主题 token | 只在映射已知且语义一致时提示。 |
relative-font-units |
偏好相对字号单位 | 按项目缩放和字体约定选择。 |
require-reference-in-vue |
检查 Vue 样式块的 reference 入口 | Tailwind v4 特有。 |
use-baseline |
提示超出所选浏览器基线的 CSS 特性 | 原生 CSS 按项目兼容目标复用现成检查。 |
use-layers |
提示使用 CSS 层叠层 | 由项目层叠架构决定。 |
valid-apply-directive |
检查 apply 指令写法 | UnoCSS 用自己的候选规则和编译验证。 |
valid-modifier-syntax |
检查 Tailwind 修饰符语法 | UnoCSS 交给本地生成器。 |
valid-theme-function |
检查 Tailwind theme() | 按 Tailwind 版本与主题路径验证。 |
oxlint-tailwindcss 1.17.1
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
no-conflicting-classes |
检查冲突的候选 | 已有样式侧冲突规则。 |
no-contradicting-variants |
检查互相矛盾的变体 | UnoCSS 已实现可确定的视口宽度空区间。 |
no-dark-without-light |
要求暗色覆盖配有默认样式 | 默认值可能来自主题或组件,保持局部例外。 |
no-duplicate-classes |
检查类串重复 | 自研 Stylelint 覆盖同块重复。 |
no-dynamic-classes |
检查动态拼类 | 模板 ESLint 负责。 |
no-unknown-classes |
校验候选并提示拼写 | 样式侧已有无效候选检查。 |
enforce-canonical |
建议规范类名 | 按 UnoCSS 的实际生成验证。 |
enforce-negative-arbitrary-values |
统一负数任意值的写法 | 依项目语法和生成结果决定。 |
no-deprecated-classes |
提醒弃用的类名 | 迁移期核对目标版本后再启用。 |
no-unnecessary-arbitrary-value |
提示可替换的任意值 | 已有等价工具类规则。 |
prefer-scale-token |
建议使用主题刻度 | 固定 px 与主题变量需要分别比较。 |
prefer-theme-tokens |
建议使用主题 token | 适合已经定义语义 token 的项目。 |
consistent-variant-order |
统一变体次序 | 需保留生成选择器的语义。 |
enforce-consistent-important-position |
统一 important 位置 | 预处理语法由构建验证,项目保留确有需要的写法。 |
enforce-consistent-line-wrapping |
控制折行 | 交给 Prettier 的 apply 换行插件。 |
enforce-consistent-variable-syntax |
统一变量引用 | 已有美元变量简写规则。 |
enforce-logical |
偏好逻辑方向 | 按 RTL 和书写模式需求启用。 |
enforce-physical |
偏好物理方向 | 按项目样式语义选择。 |
enforce-shorthand |
合并等价工具类 | 只有展开等价时才建议。 |
enforce-sort-order |
按 Tailwind 的规则排列 | UnoCSS 独立提示字典序。 |
no-unnecessary-whitespace |
检查空白 | 交给格式化。 |
max-class-count |
限制类串长度 | 类数不足以判断一个语义块是否应拆分。 |
no-arbitrary-value |
禁用任意值 | 本系列保留合法任意值。 |
no-borrowed-component-styles |
检查调用处覆盖组件视觉职责 | 模板已禁工具类,特殊组件可单独定义公开覆盖接口。 |
no-default-palette |
禁用默认调色板 | 仅用于项目自己的语义色策略。 |
no-hardcoded-colors |
禁用硬编码颜色 | 仅用于已定义例外的设计系统。 |
no-restricted-classes |
按项目名单限制类名 | 有明确禁用需求时再配。 |
Biome 2.6 Tailwind 域
| 规则 | 检查什么 | 在这套写法里的取舍 |
|---|---|---|
noTailwindArbitraryValue |
提示使用了任意值 | 保留本系列采用的任意值。 |
noTailwindLegacyUtilities |
提示 Tailwind 旧工具类 | 版本迁移时按目标预设建立名单。 |
noTailwindRawColors |
提示直接使用调色板颜色 | 设计系统采用语义颜色时可借鉴。 |
noTailwindRestyledComponents |
提示从外部重设组件样式 | 模板边界由现有 ESLint 规则处理。 |
useTailwindShorthandClasses |
提示使用简写工具类 | 保留 UnoCSS 展开等价判断。 |
useTailwindSortedClasses |
提示 Tailwind 工具类排序 | 样式侧使用独立字典序。 |
useTailwindStaticClassStrings |
提示改成可静态识别的类串 | 已有模板 ESLint 严格动态检查。 |
useTailwindVariablesShorthand |
提示变量引用简写 | 已有 UnoCSS 美元变量简写。 |