跳到主要内容

从 v3 迁移到 v4

tailwindcss@4 改动较大,直接变成了一个样式预处理器,和 sass / less 类似,所以你不应该让 tailwindcss@4sass, less 一起使用。

所以关于这方面的改动会比较多, 可能你需要把很多 .scss,.less 文件后缀改成 .css

v4 版本相比于 v3, 影响功能的重大变动较少,假如你没有用到什么复杂自定义配置,那么完全可以平滑升级上来。

重大变更

  1. 移除 jsAstToolast-grep 支持,现在全部使用 babel 进行 ast 处理,假如你使用了这个配置,你可以保持不动,或者你可以把它删掉。

特性更新

  1. 添加 @weapp-tailwindcss/merge 包作为小程序版本的 tailwind-merge
  2. 增加 ignoreTaggedTemplateExpressionIdentifiersignoreCallExpressionIdentifiers 配置,用于和 @weapp-tailwindcss/merge 结合起来使用
  3. 在安装 @weapp-tailwindcss/merge 时自动设置 ignoreCallExpressionIdentifiers['twMerge', 'twJoin', 'cva'] 默认不进行转义里面的字面量
  4. 更改 cssChildCombinatorReplaceValue 默认值从 ['view'] -> ['view', 'text'] 为了更好的小程序开发体验

重构

  1. 移除 @babel/generator 依赖
  2. 去除 weapp-tailwindcss/postcss 导出,代替可直接安装使用 @weapp-tailwindcss/postcss
  3. 增加 weapp-tailwindcss/escape 来取代 weapp-tailwindcss/replace, weapp-tailwindcss/replace 导出被移除
  4. 项目 monorepo 区分包
  5. 项目打包方式从 rollup 变为 tsup

pnpm@10.x

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