@nuxtjs/tailwindcss 是首选方案，因其专为 Nuxt 3.15+（Vite 5）优化，自动处理 PostCSS 注册、@tailwind 指令识别、JIT 扫描路径及 HMR 注入，避免手动配置陷阱。
为什么 @nuxtjs/tailwindcss 模块是首选方案
因为 Nuxt 3.15+ 默认使用 Vite 5 构建，而原生 Tailwind 集成容易在 CSS 处理链路中错位：PostCSS 插件未注册、@tailwind 指令未被识别、或 JIT 内容扫描路径未覆盖 .vue 文件。官方维护的 @nuxtjs/tailwindcss 模块已内建适配逻辑，自动处理 Vite 的 CSS 预编译、HMR 注入和构建时 Purge 规则，省去手动配置 postcss.config.js 和 vite.config.ts 的多数陷阱。
npx nuxi module add tailwindcss 后必须执行 npx nuxt prepare
仅运行 npx nuxi module add tailwindcss 不会生成 tailwind.config.ts 或 assets/css/tailwind.css。缺失这两个文件会导致：
-
@tailwind base等指令不被解析，浏览器控制台报Unknown at rule @tailwind - 自定义 theme 扩展（如
colors.primary）完全不生效 - Vite 开发服务器启动后无任何 Tailwind 类输出到 CSS
正确流程是：安装模块 → 运行 npx nuxt prepare → 检查是否生成了 tailwind.config.ts 和 assets/css/tailwind.css（后者应含三行 @tailwind 指令）。
检查 tailwind.config.ts 中的 content 路径是否匹配实际结构
Nuxt 3 默认使用 app.vue、pages/、components/、layouts/ 目录，但 @nuxtjs/tailwindcss 自动生成的 content 可能只写 ./app/**/*.{vue,ts}，漏掉 components/ 下的 SFC。结果就是：bg-primary 在页面中有效，但在自定义组件里报 Unknown class。
立即学习“前端免费学习笔记（深入）”；
手动修正为：
export default {
content: [
'./app/**/*.{vue,ts}',
'./pages/**/*.{vue,ts}',
'./components/**/*.{vue,ts}',
'./layouts/**/*.{vue,ts}',
],
}
注意：路径必须用单引号，且不能包含 node_modules 或未使用的目录，否则会拖慢 JIT 编译速度。
样式失效时优先排查 assets/css/tailwind.css 是否被正确 import
@nuxtjs/tailwindcss 模块默认会自动 import assets/css/tailwind.css，但如果你在 app.vue 或 plugins/ 中手动加了其他 CSS 引入（比如 import '~/assets/css/main.css'），就可能触发加载顺序错乱——Tailwind 规则被后加载的 CSS 覆盖。
验证方法：
- 打开浏览器开发者工具 → Elements → 选中一个元素 → 查看 Computed 样式中
background-color等属性来源 - 若看到
main.css里的body { background: white }覆盖了bg-gray-50，说明 Tailwind CSS 加载太晚 - 解决方案：删掉所有手动
importCSS 的语句，只保留@nuxtjs/tailwindcss自动注入；或确保assets/css/tailwind.css是第一个被 import 的样式文件
真正棘手的不是配置写错，而是你以为它“已经生效”了，其实只是部分文件被扫描、部分类被 Purge、部分规则被覆盖——这三者叠加时，现象极难复现，也最难定位。
