跳到内容

Tailwind CSS

Tailwind CSS 是一个实用优先的 CSS 框架,与 Next.js 完全兼容。

安装 Tailwind

安装必要的 Tailwind CSS 包

终端
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 指令,例如

styles/globals.css
@import 'tailwindcss';

自定义 app 文件 (pages/_app.js) 中,导入 globals.css 样式表以将样式应用于应用程序中的每个路由。

pages/_app.tsx
// These styles apply to every route in the application
import '@/styles/globals.css'
import type { AppProps } from 'next/app'
 
export default function App({ Component, pageProps }: AppProps) {
  return <Component {...pageProps} />
}

使用类

安装 Tailwind CSS 并添加全局样式后,您可以在应用程序中使用 Tailwind 的实用程序类。

pages/index.tsx
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 中受支持。