Tailwind在Monorepo中样式失效的根本原因是content路径解析以process.cwd()为根而非配置文件位置，需用path.resolve(__dirname, '..')构造绝对路径，并逐条写死包路径及文件后缀，配置必须用CommonJS格式（module.exports）。
Tailwind 在 Monorepo 中样式失效，根本不是配置“写错了”，而是路径解析机制和构建上下文错位导致的静默失败——content 字段扫不到文件，类名压根没生成，浏览器里看到的 class="text-xl" 就是纯摆设。
content 路径为什么总扫不到 packages/ui 里的类名
Tailwind 解析 content 字段时，始终以 process.cwd()（你执行 pnpm build 的目录）为根，而不是 tailwind.config.js 所在位置。你在 apps/web 下运行命令，但配置文件在 packages/tailwind-config，里面写的 "../packages/ui/src/**/*" 就会错位指向 apps/../packages/ui——根本不是 monorepo 根目录。
-
__dirname永远指向配置文件自身位置，不受执行目录影响，必须用path.resolve(__dirname, '..')构造绝对路径 - 通配符如
./packages/**/src/**在 Tailwind v3/v4 中不可靠，fast-glob不支持嵌套通配，必须逐条写死每个包路径 - 后缀必须显式列出：
.ts、.tsx、.svelte、.astro、.mdx漏一个就扫不到对应文件 - 不要把
node_modules加进content，除非你明确引用了第三方库源码（比如shadcn-svelte）
为什么用 workspace: 协议安装 tailwind-config 却报 Cannot use import statement outside a module
Tailwind CLI 启动时同步 require() 配置文件，只认 CommonJS。哪怕你写的是 tailwind.config.ts，只要导出是 export default config，Node 就会当作 ESM 加载，直接抛错。
- 导出形式必须是
module.exports = config，不能用export default - 配置文件里不能
import其他模块（包括你自己写的 TS 工具函数），否则触发 ESM 陷阱 - 最稳妥做法：直接用
tailwind.config.js，纯 JS，零编译干扰 - 若坚持用 TS，得确保该文件被
ts-node提前编译成 JS，且输出仍是module.exports形式 - 业务包中必须用
require("tailwind-config")引入，不能import—— Tailwind 不支持 ESM 配置入口
改完 content 后样式仍不生效？检查这三件事
路径写对了 ≠ 样式就出来。Monorepo 里漏掉任一环，都会出现“本地有效、CI 失效”“类名存在但无规则”的静默问题。
立即学习“前端免费学习笔记（深入）”；
- 每个子包应维护自己的
tailwind.config.js，避免多版本 Tailwind 行为不一致（比如 v3.4 和 v4.1 对safelist解析逻辑不同） - PostCSS 插件是否加载？
@tailwind utilities这行如果只是注释，说明插件没注册——Vite 用户要确认postcss.config.js含require('@tailwindcss/postcss')，不是旧版require('tailwindcss') - 动态类名（如
from-${color}-500）不会被扫描到，必须用safelist显式声明：safelist: ['from-blue-500', /from-[a-z]+-500/]（注意正则必须用斜杠包裹，写成字符串无效）
Monorepo 里共享 CSS 组件库不是“配个路径就能用”，而是必须同时处理构建时扫描、运行时加载、包间依赖协议和样式隔离四件事；最容易被忽略的是：所有子包的 content 路径都得用 path.resolve(__dirname, '..')，且每个包的 tailwind.config.js 必须独立存在、独立维护——共用一份配置，在 CI 环境下大概率崩。
