Tailwind在Monorepo中样式失效的根本原因是content路径以process.cwd()为根而非配置文件位置，必须用path.resolve(__dirname, '..')构造绝对路径，逐条写死包路径及后缀，且配置须为CommonJS格式。
content路径必须用path.resolve(__dirname, '..')构造绝对路径
Tailwind扫描类名时，始终以process.cwd()（你执行pnpm build的目录）为根，而不是tailwind.config.js所在位置。你在apps/web里跑命令，但配置文件在packages/tailwind-config，里面写"../packages/ui/src/**/*"就会错位指向apps/../packages/ui——根本不是 monorepo 根目录。
__dirname永远指向配置文件自身位置，不受执行目录影响。必须显式构造绝对路径：
const path = require('path')
module.exports = {
content: [
path.resolve(__dirname, '../apps/**/src/**/*.{ts,tsx,jsx,mdx}'),
path.resolve(__dirname, '../packages/**/src/**/*.{ts,tsx,jsx,mdx}'),
],
}
- 通配符如
./packages/**/src/**在 Tailwind v3/v4 中不可靠，fast-glob不支持嵌套通配，必须逐条写死 - 后缀必须显式列出：
.ts、.tsx、.svelte、.astro、.mdx，漏一个就扫不到对应文件 - 不要把
node_modules加进content，除非你明确引用了第三方库源码（比如shadcn-svelte）
配置文件必须用 CommonJS 格式：module.exports，不能export default
Tailwind CLI 启动时同步require()配置文件，只认 CommonJS。哪怕你写的是tailwind.config.ts，只要导出是export default config，Node 就会当作 ESM 加载，直接抛Cannot use import statement outside a module。
- 导出形式必须是
module.exports = config，不能用export default - 配置文件里不能
import其他模块（包括你自己写的 TS 工具函数），否则触发 ESM 陷阱 - 最稳妥做法：直接用
tailwind.config.js，纯 JS，零编译干扰 - 若坚持用 TS，得确保该文件被
ts-node提前编译成 JS，且输出仍是module.exports形式
业务包中必须require("tailwind-config")引入，不能import
即使你把配置抽成独立包（如@myorg/tailwind-config），Tailwind 也不支持 ESM 配置入口。所有业务包或组件包都必须用require()加载：
立即学习“前端免费学习笔记（深入）”；
// apps/web/tailwind.config.js
const baseConfig = require('tailwind-config')
module.exports = {
...baseConfig,
// 可覆盖 theme 或 plugins
}
- 安装方式必须是
pnpm add -D workspace:tailwind-config，确保package.json中出现"tailwind-config": "workspace:^0.0.0" - 不能用
npm link或手动拷贝配置文件，否则 Turborepo 缓存和增量构建会失效 - 若用 Turborepo，
turbo.json中需声明"pipeline.build.dependsOn"包含该配置包，否则修改后缓存不更新
改完content后样式仍不生效？检查这三件事
路径写对了 ≠ 样式就出来。Monorepo 里漏掉任一环，都会出现“本地有效、CI 失效”“类名存在但无规则”的静默问题。
- 每个子包应维护自己的
tailwind.config.js，避免多版本 Tailwind 行为不一致（比如 v3.4 和 v4.1 对safelist解析逻辑不同） - PostCSS 插件是否加载？
@tailwindcss/postcss必须在postcss.config.js中正确注册，否则@tailwind指令不解析 - 确认
contentglob 是否真正命中目标文件——Tailwind 不报错也不提示“没扫到”，只会静默生成极小的 CSS。建议在构建后检查输出 CSS 文件大小，或临时加个safelist: ['text-9xl']验证是否提取成功
content glob 的实际匹配结果——它不报错，也不警告，只默默生成空 CSS。 
