用途
本技能聚焦 Tailwind CSS v4 的迁移与版本差异查询,适用于三类场景:将项目从 Tailwind v3 迁移到 v4;查阅 @theme 命名空间与自动生成工具类的对应关系;查找在 v3 中已被重命名或移除的工具类。资料明确说明,它不承担日常 CSS-first 配置参考(@theme/@utility/@variant 的常规使用由 tailwindcss-core 负责),也不做普通工具类查找。
版本概览
资料标注当前稳定版为 tailwindcss 4.3.3。v4.0 之后的小版本更新包括:v4.1 增加文字阴影、遮罩(masks);v4.2 增加 mauve/olive/mist/taupe 调色板、@tailwindcss/webpack、逻辑属性工具类 pbs/mbs/inline-/block-/inset-s|e|bs|be、font-features-,并弃用 start-/end-;v4.3 增加滚动条工具类、@container-size、zoom-、tab-*、堆叠与复合 @variant,以及功能型 @utility 中的 --default()。
主要能力
-
@theme 命名空间速查:列出 --color-* 生成 bg-/text-/border-/fill- 等,--font-* 生成 font-,--text- 生成 text-xs/text-sm/text-base 等,--spacing-* 生成 p-/m-/gap-/w-/h-,--radius-* 生成 rounded-,--shadow- 生成 shadow-,--breakpoint- 生成 sm:/md:/lg:/xl: 等,--animate-* 与 --ease-* 对应动画和缓动工具类。
-
v3 → v4 破坏性变更梳理:
- 指令变化:v3 的 @tailwind base/components/utilities 改为 v4 的 @import "tailwindcss"。
- 工具类重命名:shadow-sm→shadow-xs、shadow→shadow-sm、rounded-sm→rounded-xs、rounded→rounded-sm、outline-none→outline-hidden、ring→ring-3。
- 移除的弃用工具类:bg-opacity-* 改用 bg-black/50 这类写法,text-opacity-* 改用 text-black/50,flex-shrink-* 改用 shrink-,flex-grow- 改用 grow-*。
- 自定义工具类语法:v3 的 @layer utilities { .tab-4 { ... } } 改为 v4 的 @utility tab-4 { ... }。
- 任意值中的变量写法:bg-[--brand-color] 改为 bg-(--brand-color)。
- 重要修饰符位置:!bg-red-500 改为 bg-red-500!。
-
升级工具:提供命令 npx @tailwindcss/upgrade,要求 Node.js 20+。
-
详细参考文档入口:configuration.md 用于编写 CSS-first @theme 配置或使用 @utility/@variant/@custom-variant 指令;api-functions.md 用于 --alpha()/--spacing() CSS 函数或 @apply;installation-support.md 用于安装 Tailwind v4(npm/Vite/CLI/webpack)或查看浏览器支持。
使用方式
作为 Claude 插件技能按需加载:迁移项目或查改名/移除工具类时启用;具体主题配置、工具类与变体编写查阅 tailwindcss-core 与 tailwindcss-custom-styles。
适用场景
适合正在升级 Tailwind 版本、需要对照新旧类名和指令写法的前端项目,以及需要确认某个 v3 类在 v4 中对应名称的开发者。
限制
资料未提供该技能的安装方式、收费信息、支持平台与效果数据,这些内容暂未提供。它不覆盖日常配置参考与工具类查询,相关任务应参考其他技能。