Tailwind CSS v3到v4升级简易指南
最近在用Tailwind CSS v3.4构建个人博客时，我需要将Tailwind CSS升级到最新版本。官方迁移指南很有帮助，但对于如何处理@tailwindcss/typography和@tailwindcss/forms插件的升级却语焉不详。本文将提供一个简短的升级步骤。
前提条件
假设您已熟悉Tailwind CSS的基本使用方法。本文以SvelteKit为例，但适用于任何需要将Tailwind CSS从v3迁移到v4的项目。
立即学习“前端免费学习笔记（深入）”；
升级步骤
步骤1：使用Tailwind CSS升级工具
Tailwind CSS团队提供了一个方便的升级工具，可以简化升级过程。在项目根目录运行以下命令：
npx @tailwindcss/upgrade@next
按照提示进行操作，该工具会自动修复代码中的部分兼容性问题，更新PostCSS配置（如果适用），并修正主CSS文件中的导入语句以及package.json中的版本号。 部分需要手动修改的地方，工具会提示您。
步骤2：插件的使用
升级工具完成基本迁移后，接下来处理插件。许多项目不仅仅使用Tailwind CSS的基本配置，例如，@tailwindcss/typography插件对于散文样式至关重要：
.content {
@apply dark:prose-invert prose-headings:font-bold prose-a:no-underline hover:prose-a:underline prose-pre:rounded-lg prose-pre:p-4;
}
如果没有该插件，您会遇到类似“cannot apply unknown utility class: dark:prose-invert”的错误。 同样，@tailwindcss/forms插件对于表单元素（特别是复选框）的样式至关重要。
在Tailwind CSS v3中，插件的配置在tailwind.config.ts文件中完成：
// tailwind.config.ts (v3)
import forms from '@tailwindcss/forms';
import typography from '@tailwindcss/typography';
import type { Config } from 'tailwindcss';
export default {
// ...
plugins: [typography, forms, ...],
} satisfies Config;
但在v4中，您可以直接在主CSS文件中导入插件：
@import "tailwindcss"; @plugin "@tailwindcss/typography"; @plugin "@tailwindcss/forms"; @plugin ...;
这样，Tailwind CSS就能正确编译。
步骤3：启用暗模式
Tailwind CSS v4默认使用prefers-color-scheme媒体查询来支持暗模式。但许多开发者习惯使用类名来切换明暗主题。在v3中，我们通过tailwind.config.ts中的darkMode选项来配置：
// tailwind.config.ts (v3)
export default {
// ...
darkMode: 'class',
// ...
} satisfies Config;
在v4中，同样在主CSS文件中进行配置：
@import "tailwindcss"; ... @custom-variant dark (&:where(.dark, .dark *));
这样就能恢复之前的暗模式切换功能。
总结
以上就是Tailwind CSS v3到v4升级的简要步骤。如果您有其他技巧或经验，欢迎分享！
作者介绍
作者是一名软件工程师和技术作家，积极寻求新的职业机会，尤其是在网络安全、金融、医疗保健和教育领域。如果您认为我的技能与您的团队需求相符，欢迎联系我！您可以在LinkedIn和X（Twitter）上找到我，也可以通过电子邮件联系我。
如果您觉得这篇文章对您有所帮助，请分享给您的朋友和同事！
