Tailwind CSS跨包配置失效的根本原因是tailwind.config.js未用CommonJS导出或content路径未覆盖子包源码；必须用module.exports导出，且content需显式包含如"../packages//src//*.{ts,tsx}"等workspace路径，并排除dist等构建产物。
Tailwind CSS 配置无法跨包生效，根本原因是 tailwind.config.js 被当作 ESM 加载或 content 路径没扫到目标文件——不是“共享失败”，而是配置没被正确读取或扫描范围为空。
tailwind.config.js 必须用 CommonJS 导出
哪怕你写的是 tailwind.config.ts，Tailwind CLI 启动时只同步加载 CommonJS 模块。ESM 导出会直接报 Cannot use import statement outside a module。
- ✅ 正确写法：
module.exports = { content: [...], theme: {...}, plugins: [...] } - ❌ 错误写法：
export default { ... }或import ... from在配置文件里 - ⚠️ 如果坚持用 .ts 后缀，必须确保它被提前编译为 .js 且导出仍是
module.exports形式；更稳方案是直接用tailwind.config.js
content 路径必须覆盖所有子包源码目录
Tailwind 不会报错说“没找到任何类”，它只会静默生成一个极小的 CSS 文件（比如只有 @layer base）。验证是否生效，最简单方式是临时加个明显类名（如 bg-[#ff0000]）看是否出现在最终 CSS 里。
- ✅ 推荐写法（pnpm workspace 常见结构）：
"../apps/**/src/**/*.{ts,tsx,jsx,mdx}"和"../packages/**/src/**/*.{ts,tsx,jsx,mdx}" - ❌ 错误写法：
"./src/**/*.{ts,tsx}"（只扫当前包）、"**/src/**/*.{ts,tsx}"（可能漏掉根路径外的包） - ⚠️ 必须排除构建产物：
!../**/dist/**、!../**/.next/**等要显式加入content数组，否则可能触发重复扫描或性能问题
子包中如何正确引用共享配置
不能靠 import，也不能靠符号链接或复制。pnpm 的 workspace: 协议才是可靠路径解析基础。
立即学习“前端免费学习笔记（深入）”；
- ✅ 在基础配置包（如
packages/tailwind-config）中：pnpm add -D tailwindcss，不装postcss或autoprefixer - ✅ 在业务子包中：
pnpm add -D workspace:tailwind-config，确保package.json出现"tailwind-config": "workspace:^0.0.0" - ✅ 在
tailwind.config.js中：const sharedConfig = require('tailwind-config');，再用mergeConfig或展开合并 - ⚠️ Turborepo 用户：务必在
turbo.json的pipeline.build.dependsOn中声明该配置包，否则缓存会跳过它的变更
最容易被忽略的其实是 content glob 是否真能匹配到文件——Tailwind 不校验路径有效性，也不提示缺失。建议在子包中放一个测试组件，写几个带 Tailwind 类的 JSX，然后运行 npx tailwindcss -o ./out.css --minify 直接生成一次，检查输出是否包含预期类名。路径不对，就等于没配。
