跳到正文

我所理解的 UnoCSS 最佳实践(7):利用 Lint 规范写法

我所理解的 UnoCSS 最佳实践

  1. 为什么选择 UnoCSS
  2. CSS 如何减少重复
  3. 语义类名与工具类的工程实践
  4. Tailwind CSS 与 UnoCSS 的兼容边界
  5. Wind3 与 Wind4 的区别与迁移
  6. 工具类、任意值与任意属性怎么选
  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 冲突诊断与跨引擎编译实测

打开原文件 lint-tool-probes.json

{
  "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 美元变量简写。