从 v3 迁移到 v4
tailwindcss@4 改动较大,直接变成了一个样式预处理器,和 sass / less 类似,所以你不应该让 tailwindcss@4 和 sass, less 一起使用。
所以关于这方面的改动会比较多, 可能你需要把很多 .scss,.less 文件后缀改成 .css
v4 版本相比于 v3, 影响功能的重大变动较少,假如你没有用到什么复杂自定义配置,那么完全可以平滑升级上来。
重大变更
- 移除
jsAstTool的ast-grep支持,现在全部使用babel进行ast处理,假如你使用了这个配置,你可以保持不动,或者你可以把它删掉。
特性更新
- 添加
@weapp-tailwindcss/merge包作为小程序版本的tailwind-merge - 增加
ignoreTaggedTemplateExpressionIdentifiers和ignoreCallExpressionIdentifiers配置,用于和@weapp-tailwindcss/merge结合起来使用 - 在安装
@weapp-tailwindcss/merge时自动设置ignoreCallExpressionIdentifiers为['twMerge', 'twJoin', 'cva']默认不进行转义里面的字面量 - 更改
cssChildCombinatorReplaceValue默认值从['view']->['view', 'text']为了更好的小程序开发体验
重构
- 移除
@babel/generator依赖 - 去除
weapp-tailwindcss/postcss导出,代替可直接安装使用@weapp-tailwindcss/postcss - 增加
weapp-tailwindcss/escape来取代weapp-tailwindcss/replace,weapp-tailwindcss/replace导出被移除 - 项目
monorepo区分包 - 项目打包方式从
rollup变为tsup
[email protected]
假如你已经升级到了 [email protected],在安装依赖后,可能需要执行 pnpm approve-builds 来运行一些 npm hook 命令
