用途:该技能用于指导在项目中实现或审查 Tailwind CSS v4,适合安装 Tailwind、编写 UI 样式、构建响应式与深色模式布局,以及基于 CSS-first 方式扩展主题、工具类与变体。
主要能力:覆盖安装集成(@tailwindcss/vite、@tailwindcss/postcss、@tailwindcss/webpack、@tailwindcss/cli)、工具类用法、@theme 设计令牌、响应式与容器查询、变体、Preflight、源码检测、布局与排版、视觉与交互效果、深色模式、自定义样式及从 v3 到 v4 的升级迁移。资料还列出了 v4.3 新增能力,如滚动条工具类、尺寸容器、zoom、tab 尺寸、CSS 中的变体、函数指令回退值等。
使用方式:编辑前先检查项目,确认已安装版本、包管理器、构建集成、主 CSS 入口、旧配置或插件、源码根目录及现有令牌和组件;不要仅因版本较新就升级项目。按技术栈选择官方集成方式,优先使用最小可行的样式机制:已有工具类或组件优先,一次性场景用任意值,可复用设计值用 @theme 令牌,可复用 CSS 能力用 @utility。保持候选类名可静态检测,避免拼接字符串。保留既有设计系统约定。最后运行相关构建、类型、lint 或测试,并确认编译 CSS 与渲染效果。
限制与注意:v4 采用 CSS-first,旧版 JavaScript 配置需通过 @config 显式启用且不会自动检测,部分 v3 选项已不支持。资料强调不要在 v3 项目中随意升级,不要在样式表前引入 Sass/Less/Stylus,也不要在生产环境使用 Play CDN。若需确认最新版本,应重新查看官方文档与 npm 标签。