SuperAPI AI 工具集

nativewind-and-tailwind-css-compatibility

前端与建站

查看项目

更新于 10-16 02:36

技能介绍

用途:为 NativeWind 与 Tailwind CSS 的搭配提供具体版本兼容性说明,防止常见安装与运行时错误。

主要能力与兼容结论:资料指出应使用 nativewind@2.0.11 搭配 tailwindcss@3.3.2;更高版本可能触发 'process(css).then(cb)' 错误,原因是 PostCSS API 不兼容,该组合是 NativeWind v2 下唯一经核验兼容的配对。

必要用法:若出现错误,先移除两个包再一起重装: npm remove nativewind tailwindcss npm install nativewind@2.0.11 tailwindcss@3.3.2 需在 tailwind.config.js 中加入 preset:presets: [require('nativewind/preset')]。缺少该 preset 时,Tailwind 可编译类名,但 NativeWind 无法将其注入 React Native 的 StyleSheet 引擎,样式不生效。修复版本问题时必须同时移除并重装两个包,只升级其中一个会留下不兼容的 peer 依赖,产生难以定位的 PostCSS 错误。

限制与注意事项:不要在未核验兼容矩阵的情况下升级 nativewind 或 tailwindcss;NativeWind v4 架构完全不同,未迁移直接升级会导致所有样式被静默丢弃。不要将 Tailwind CSS v4 与 NativeWind v2 组合,v4 移除了 v2 依赖的 JIT 配置 API,样式会静默不生效。不要混用 v2 与 v4 文档。资料另提及一套可选的内存记录流程,要求开始前执行 cat .claude/context/memory/learnings.md。其他收费、平台与效果信息暂未提供。