在 Next.js 应用中安装 Tailwind CSS 的方法

Tailwind CSS 是一个实用优先的 CSS 框架，完全兼容 Next.js。本指南将引导你完成在 Next.js 应用中安装 Tailwind CSS 的过程。

安装 Tailwind

安装必要的 Tailwind CSS 包：

终端

npm install -D tailwindcss @tailwindcss/postcss postcss

小知识：如果使用 create-next-app CLI 创建项目，Next.js 会询问是否安装 Tailwind 并自动配置项目。

配置 Tailwind

在项目根目录创建 postcss.config.mjs 文件，并将 @tailwindcss/postcss 插件添加到 PostCSS 配置中：

postcss.config.mjs

/** @type {import('tailwindcss').Config} */
export default {
  plugins: {
    '@tailwindcss/postcss': {},
  },
}

从 Tailwind v4 开始，默认情况下无需任何配置。如需配置 Tailwind，可参考官方文档配置全局 CSS 文件。

如果你有现有的 Tailwind v3 项目，还有升级 CLI 和指南可供参考。

导入样式

将 Tailwind CSS 指令添加到应用的全局样式表中，Tailwind 会通过这些指令注入生成的样式，例如：

app/globals.css

@import 'tailwindcss';

在根布局 (app/layout.tsx) 中导入 globals.css 样式表，将样式应用到应用中的每个路由。

import type { Metadata } from 'next'

// 这些样式会应用到应用中的每个路由
import './globals.css'

export const metadata: Metadata = {
  title: 'Create Next App',
  description: 'Generated by create next app',
}

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  )
}

使用类名

安装 Tailwind CSS 并添加全局样式后，即可在应用中使用 Tailwind 的实用类。

export default function Page() {
  return <h1 className="text-3xl font-bold underline">Hello, Next.js!</h1>
}

与 Turbopack 配合使用

从 Next.js 13.1 开始，Tailwind CSS 和 PostCSS 已支持 Turbopack。