根本原因是content配置未覆盖所有packages路径，需手动列出每个含JSX/TSX的package目录，如"./packages/button/src/*/.{js,jsx,ts,tsx}"，且必须重启dev server并清除缓存。
Monorepo 项目中 Tailwind CSS 扫描不到类名，根本原因不是插件失效或版本冲突，而是 content 配置只覆盖了当前 package 的路径，没覆盖 workspace 中其他 packages 的源码文件。
content 数组必须显式列出所有含 JSX/TSX 的 packages 路径
Tailwind 不会自动递归扫描 node_modules 或 packages/ 下未声明的子目录。即使你用的是 pnpm workspaces 或 yarn workspaces，content 仍需手动写全路径 —— 它不识别 workspace 协议或符号链接。
-
./src/**/*.{js,jsx,ts,tsx}只扫当前 package 的src，对packages/ui或packages/utils完全无效 - 常见错误是只配了
./packages/**/*.{js,jsx,ts,tsx}，但漏掉了.vue、.svelte或.astro后缀（如果项目混用框架） - 路径必须以
./开头，不能写packages/**—— 否则 Tailwind 会静默忽略
pnpm/yarn workspace 下的相对路径要按实际磁盘结构写
比如你的 monorepo 根目录下有 packages/button 和 packages/card，而 tailwind.config.js 在根目录，那必须这样写：
content: [
"./apps/web/src/**/*.{js,jsx,ts,tsx}",
"./packages/button/src/**/*.{js,jsx,ts,tsx}",
"./packages/card/src/**/*.{js,jsx,ts,tsx}",
"./packages/shared/**/*.{js,jsx,ts,tsx}",
]
不要试图用通配符简化成 ./packages/**/src/**/*.{js,jsx,ts,tsx} —— Tailwind 的 glob 解析器不支持多级通配嵌套，该写法在 v3/v4 中均不可靠。
立即学习“前端免费学习笔记（深入）”；
- 如果某个 package 用的是
lib而非src目录，路径就得对应改成./packages/foo/lib/**/*.{js,jsx,ts,tsx} - 使用 TypeScript 的项目，确保包含
.d.ts文件（虽然通常不写类名，但某些declare module场景会用到）
配置生效后必须重启 dev server，且注意缓存行为
Tailwind 在开发时会缓存已扫描的文件列表。改完 content 后只热更新是不够的，必须彻底重启 vite dev 或 next dev 进程。
- VS Code 中保存
tailwind.config.js后，终端里看到 “restarting dev server…” 并不等于 Tailwind 已重扫 —— 它可能还在用旧缓存 - 可临时加个无害类如
bg-[#ff0000]到某个组件里，再检查浏览器元素面板是否出现对应样式；没出现就说明扫描仍未生效 - 某些构建工具（如 Turborepo）会在 root 层做缓存，需运行
turbo prune清除，否则子 package 的变更可能被跳过
最易被忽略的一点：Tailwind v4 的 CSS-first 模式（@theme）目前仍不支持跨 package 主题注入，所有 @layer 或 @apply 仍依赖 JS 配置中的 content 路径扫描 —— 别指望把主题抽到独立包里就能自动生效。
