SuperAPI AI 工具集

tailwind-errors-specificity

前端与建站

查看项目

更新于 10-15 22:18

技能介绍

用途:诊断 Tailwind CSS 中“工具类已编译却不生效”的层叠(cascade)与特异性(specificity)问题,覆盖五种机制:@layer 层级优先级(base < components < utilities < 未分层)、单类选择器特异性(0,0,1,0)、同一类内声明顺序(后写胜出)、!important 修饰符、以及插件加载顺序。

主要能力:提供决策树排查工具类失效;说明未分层 CSS 会压倒所有 Tailwind 输出,应将自定义规则移入 @layer components 或 utilities;区分 v3 前缀式 !font-bold 与 v4 后缀式 font-bold! 的写法差异;指出 v3 中 @apply 默认剥离 !important(需写 @apply p-4 !important),而 v4 会保留(@apply p-4!);说明 v3 plugins 数组中后加载插件覆盖先加载;同一 @apply 行内同属性冲突按声明顺序判定(如 px-4 py-2 px-8 中 px-8 胜出);v4 推荐用 @utility 而非 @layer utilities 添加自定义工具;内联 style 通常胜出,仅带 ! 修饰符的工具可覆盖;Vue/Svelte scoped 样式或 CSS Modules 需用 @reference 引入主题后才能 @apply。

适用场景:工具类被组件类或第三方 CSS(如 Bootstrap)盖过、hover/focus 变体覆盖、插件产出的组件类(prose-、form-)压过工具类等。

限制:不涉及类未编译进 CSS(另见构建失败技能)、DOM 属性问题(class 与 className)、@apply 组件组合、自定义插件编写、prefix/important 配置及 @theme 令牌。资料未提供价格或收费信息。