weapp-tailwindcss

weapp-tailwindcss 是一个构建期工具，解决的是 Tailwind CSS 在小程序里水土不服的问题。小程序不支持部分选择器、单位和类名写法，直接套用官方生成结果往往样式不生效。它把 Tailwind 的生成结果接过来，再做一层转义与适配，让同一份样式入口能同时产出 Web 和小程序可用的 CSS。

主要功能

它只转换 Tailwind 已经生成出来的类名，业务代码里的普通字符串不会被误改。输出目标可以按平台切换：Web 走原生 Tailwind 语义，小程序则补上选择器、单位和转义处理，也能生成原生样式清单。运行时还提供 merge、variants、cva 这一组工具，让类名合并在小程序端保持一致。

支持的框架

• uni-app、Taro、Mpx、Weapp-vite 等小程序框架
• React Native、Lynx 等原生跨端方案
• Webpack、Vite、Gulp 及自定义 Node 构建流程

构建器负责生成，weapp-tailwindcss 负责转换，文档建议小程序构建不要再叠加官方 Tailwind 生成插件，避免重复处理。

适合谁

已经在用 Tailwind CSS 4、又要同时维护 H5 和小程序版本的团队，可以保留一个样式入口，把各框架的接线交给它处理。文档有中英文版本，并提供给模型读取的紧凑索引，方便让 AI 给出较新的配置建议。