用途:在需要以工具类优先(utility-first)方式编写样式、构建响应式设计或配置 Tailwind 主题时使用。不适用于 MUI、纯 CSS 或复杂动画场景。
主要能力:使用工具类直接完成样式(如 bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded);通过断点前缀实现响应式(md:flex lg:grid);配置主题令牌(v3 用 tailwind.config.js 的 theme.extend,v4+ 用 @theme 块与 OKLCH);配置暗色模式(v3 在配置中启用,v4 用 @custom-variant dark);使用 CVA 处理组件变体;用 clsx/cn 处理条件样式。
使用方式:优先在 HTML 中直接使用工具类;共享组件模式才用 @apply,避免滥用;自定义颜色/间距加入主题而非硬编码十六进制;动态值用内联样式或任意值类(如 w-[137px]),但应尽量减少;确保 content 数组覆盖所有模板路径,避免生产构建类被清除。
限制与注意:工具类同优先级,HTML 顺序影响结果,慎用 !;第三方内联样式会覆盖,需用 !important 或包裹层;Tailwind 无法检测动态拼接的类名;@apply 过度使用会违背工具类优先原则。
补充资料:design-system.md 涉及令牌层级、语义命名、CVA 与暗色模式;tailwind-v4.md 涉及 v4 迁移、OKLCH 与 @theme。官方文档见 https://tailwindcss.com/docs,CVA 见 https://cva.style/docs,OKLCH 见 https://oklch.com/。