共享css组件库在monorepo中需解决路径解析、样式提取、依赖协议和加载机制四层耦合：tailwind content需显式跨包配置，配置文件须为commonjs格式，pnpm workspace协议为缓存前提，unocss等同理需扩展扫描路径，工具链均需适配monorepo的多根假设。
因为共享CSS组件库不是“复制粘贴就能用”的静态资源，它牵扯到构建时的路径解析、样式提取时机、包间依赖协议和运行时加载机制四层耦合问题。
tailwind.config.ts 的 content 路径无法跨包自动识别
Tailwind 依赖 content 字段扫描源码提取类名。Monorepo 中业务包（如 apps/web）和 UI 包（如 packages/ui）物理路径分离，但 content 默认只认当前包内路径。
- 错误写法：
"./src/**/*.{ts,tsx}"—— 只扫当前包，packages/ui里的组件类名完全漏掉 - 正确写法需显式声明跨包路径：
"../apps/**/src/**/*.{ts,tsx}"和"../packages/**/src/**/*.{ts,tsx}" - 路径层级必须与
pnpm-workspace.yaml实际结构严格匹配；多一层或少一层..，Tailwind 就静默失效，不报错也不生成样式
配置包必须导出为 CommonJS，且不能依赖 TS 编译时机
Tailwind CLI 启动时同步读取配置文件，只支持 CommonJS 格式。哪怕你用 .ts 后缀写配置，也必须确保最终被 require() 加载的是 module.exports 形式。
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
- 禁止写
export default config—— 会触发Cannot use import statement outside a module - 更稳妥做法：直接用
tailwind.config.js，内容纯 JS，避开 TS 类型和编译顺序干扰 - 若坚持用
.ts，必须保证该文件被ts-node或构建流程提前转成.js，且导出是module.exports = config
pnpm workspace: 协议不是“可选”，而是构建缓存的前提
用 npm link 或手动拷贝配置文件，会导致 Turborepo 缓存失效、增量构建跳过变更、CI 环境构建不一致。
- 必须在业务包中执行：
pnpm add -D workspace:tailwind-config - 检查
package.json中是否出现："tailwind-config": "workspace:^0.0.0" - 配置文件里必须用
require("tailwind-config")，不能用import—— Tailwind 不支持 ESM 入口 -
turbo.json中需声明："pipeline.build.dependsOn": ["^build"]或显式包含该配置包，否则修改配置后缓存不更新
UnoCSS / Windi CSS 等原子化引擎同样卡在路径扫描上
UnoCSS 不是 Tailwind 的替代品，而是另一套扫描逻辑。它默认只扫描当前工作区目录，对 packages/ui 这类被引用但不在当前 apps/web 目录下的源码，根本不会触达。
- 必须显式扩展
content或include列表，指向所有含 JSX/TSX 的包路径 - 某些插件（如
@unocss/webpack）需额外配置transformers才能处理跨包导入的组件 - 热更新失效常因 watch 路径未覆盖
packages/目录 —— 需在 dev server 配置中手动加入watchOptions
真正难的不是“怎么配”，而是所有工具链（Tailwind、UnoCSS、Webpack、Vite、Turborepo）都默认假设“一个项目一个根”，而 Monorepo 强行打破这个假设——每层工具都要手动对齐路径、协议和加载时机，漏掉任意一环，样式就消失得无声无息。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
