Tailwind CSS

Tailwind CSS 是一个功能优先的 CSS 框架，与 Next.js 完全兼容。

安装 Tailwind

安装必要的 Tailwind CSS 包：

Terminal

npm install -D tailwindcss @tailwindcss/postcss postcss

配置 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 用于注入其生成样式的 Tailwind CSS 指令添加到应用程序中的全局样式表，例如：

app/globals.css

@import 'tailwindcss';

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

app/layout.tsx

TypeScript

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 的实用类。

app/page.tsx

TypeScript

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。