用途:该技能用于在 Next.js(App Router,15+)、Vite 或 Tailwind CLI 环境中安装并使用 Tailwind CSS v4,以单一用途的工具类组合来编写样式,并说明 v4 的 CSS 化主题配置方式。
主要能力:支持在标记中组合工具类(如 text-3xl font-bold underline、flex items-center gap-4、p-6 rounded-xl bg-white shadow-lg);通过 @theme 扩展或覆盖默认主题令牌(颜色、字体、断点、间距、圆角、阴影、缓动、动画等命名空间);支持 @layer base 与 @layer components 自定义样式、@utility 自定义工具类、@variant 与 @custom-variant 自定义变体,以及任意值与任意属性写法(如 top-[117px]、fill-(--my-brand-color)、[mask-type:luminance],空格用下划线表示)。
使用方式:Next.js 需添加 tailwindcss、@tailwindcss/postcss、postcss,并在项目根创建 postcss.config.mjs,内容为 plugins 中的 "@tailwindcss/postcss": {};在 ./app/globals.css 写 @import "tailwindcss";。Vite 需添加 tailwindcss、@tailwindcss/vite,并在 vite.config.ts 的 plugins 中加入 tailwindcss()。CLI 需添加 tailwindcss、@tailwindcss/cli,命令为 @tailwindcss/cli -i ./src/input.css -o ./src/output.css --watch。入口均为一个含 @import "tailwindcss"; 的主 CSS 文件。React/Next 用 className,Qwik/Vue 用 class。
限制:仅使用 v4,不创建或建议任何 tailwind.config.*,不在 JS 配置中写 content、theme 或 plugins。不要与 Sass、Less、Stylus 同一管线使用。v4 面向现代浏览器(Chrome 111+、Safari 16.4+、Firefox 128+),旧浏览器支持需避开部分新工具类。