从 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
pnpm@10.x
假如你已经升级到了 pnpm@10.x
,在安装依赖后,可能需要执行 pnpm approve-builds
来运行一些 npm hook
命令