Tailwind CSS v3在Monorepo中content路径必须用path.resolve(__dirname, ...)锚定，因其仅做字符串匹配、不理解workspace协议，且扫描根为process.cwd()而非配置文件位置；相对路径如"../packages//src/"会因执行目录变化而错位，fast-glob不支持嵌套通配，须逐条写死并显式列出所有后缀，配置必须为CommonJS格式（module.exports），禁用export default和import。
Tailwind CSS v3 在 Monorepo 中无法自动识别包结构，content 路径必须用 path.resolve(__dirname, ...) 锚定配置文件位置，否则构建时会静默漏扫 —— 这不是 bug，是设计使然。
为什么 content 里写 "../packages/**/src/**" 会失效
Tailwind v3 的 content 字段只做字符串路径匹配，不理解 pnpm workspace: 协议，也不做动态解析。它扫描时以 process.cwd()（你执行命令的目录）为根，而不是 tailwind.config.js 所在位置。
比如你在 apps/web 下运行 pnpm build，process.cwd() 就是 apps/web；此时 "../packages/**/src/**" 实际指向的是 ../packages/**/src/**（即 monorepo-root/apps/../packages），根本不是你想要的 monorepo-root/packages。
- 必须用
const path = require('path')+path.resolve(__dirname, '../packages/ui/src/**/*.{ts,tsx,jsx,mdx}') -
__dirname永远指向配置文件自身所在目录，不受执行位置影响 - 通配符如
"./packages/**/src/**"在 v3 中不可靠 ——fast-glob不支持嵌套通配，必须逐条写死
tailwind.config.js 必须是 CommonJS 格式
Tailwind CLI 启动时同步 require() 配置文件，只认 module.exports。哪怕你用 .ts 后缀，只要导出是 export default，Node 就按 ESM 加载，直接报 Cannot use import statement outside a module。
立即学习“前端免费学习笔记（深入）”；
- 禁止写
export default config或任何import语句 - 不能
import工具函数、类型定义或其他 TS 模块 - 最稳妥做法：直接用
tailwind.config.js，纯 JS，零编译干扰 - 若坚持用 TS，必须确保最终输出是
module.exports = config，且被ts-node或构建流程提前编译
如何让多个子包共享同一份配置
抽一个独立包（如 @myorg/tailwind-config）存放 tailwind.config.js，所有业务包通过 require() 引入 —— Tailwind 不支持 ESM 配置入口，import 会失败。
- 在基础包中：只装
tailwindcss为devDependencies，不装postcss或autoprefixer - 在业务包中：运行
pnpm add -D workspace:tailwind-config，确保package.json出现"tailwind-config": "workspace:^0.0.0" - 业务包的
tailwind.config.js写法：
const baseConfig = require('tailwind-config')
module.exports = {
...baseConfig,
// 可覆盖 theme、plugins、content 等字段
}
注意：content 字段在继承时不会自动合并，需显式拼接或重写。
容易被忽略的后缀与路径细节
v3 对文件后缀极其敏感，漏一个就等于放弃整类组件。同时，路径层级必须和 pnpm-workspace.yaml 实际结构严格一致 —— 多一层或少一层 ..，Tailwind 都不会报错，只会静默跳过。
- 后缀必须显式列出：
.ts、.tsx、.jsx、.mdx、.vue、.svelte、.astro（根据你实际用的框架） - 不要把
node_modules加进content，除非你明确引用了第三方库源码（如shadcn-svelte） - 排除构建产物目录：
!../**/dist/**、!../**/.next/**，避免重复扫描或意外提取 - Windows 下
path.resolve()返回反斜杠路径，Tailwind 完全兼容，无需转义
最常出问题的地方，往往不是逻辑多复杂，而是 path.resolve(__dirname, '..') 少了一个点，或者 .tsx 拼成了 .ts —— Tailwind 不会提示，你只能靠检查最终 CSS 文件里有没有对应规则来验证。
