TailwindCSS v4 迁移踩坑记录

背景

TailwindCSS v4 带来了全新的引擎和更好的性能，但在迁移过程中有一些 breaking changes 需要注意。

主要变更

1. 配置文件格式变化

v4 不再使用 tailwind.config.js，改为 CSS 原生配置：

@import "tailwindcss";

@theme {
  --color-primary: #3b82f6;
  --font-sans: "Inter", sans-serif;
}

2. JIT 引擎优化

v4 的新引擎编译速度提升了 10 倍以上，开发体验更好。

3. 部分工具类变更

一些工具类名称和用法发生了变化，需要逐一排查。

迁移建议

1. 先在分支上尝试，确认无误后再合并
2. 使用官方迁移工具辅助
3. 重点检查自定义配置和插件