用途:指导把项目从 Tailwind CSS v3.4 迁移到 v4.0+,先审计、再自动化、最后验证。
主要能力:提供是否迁移的决策依据(浏览器支持、是否用 Sass/Less/Stylus、corePlugins、resolveConfig、是否新项目等);自动化升级路径(git checkout -b chore/tailwind-v4 与 npx @tailwindcss/upgrade,需 Node.js 20+,分依赖更新、配置转换、模板改写三阶段);迁移前审计清单(corePlugins、safelist、separator、prefix、resolveConfig、默认边框色、默认 ring、Sass、作用域 @apply、动态透明度);破坏性变更处理(尺寸刻度整体位移、outline/ring 重命名、移除的废弃工具类、变体堆叠顺序反转、! 修饰符位置、任意值变量括号、逗号改下划线、前缀语法、默认颜色变化、hover 门控、theme() 弃用、corePlugins/safelist/separator/resolveConfig 移除);monorepo 双版本策略;迁移后验证(构建、产物检查、视觉回归、@apply 扫描、动态类名冒烟测试、插件兼容)。
使用方式:按资料给出的命令与代码片段执行,如 npx @tailwindcss/upgrade、@source inline("class-list")、@reference "../app.css"、@custom-variant hover (&:hover)、@theme 中恢复默认 ring 与边框色等。
适用场景:需要评估或执行 v3→v4 升级的前端项目与组件库。
限制:自动化工具不覆盖动态类名字符串、作用域 @apply、部分自定义插件与默认颜色导致的视觉回归;v4 不支持与 CSS 预处理器并用;v3.4 仍获安全补丁,无迫切升级必要。具体收费、平台等信息暂未提供。