当前位置：首页 > news >正文

Next.js-样式处理

news 2026/2/8 8:45:08

#题引：我认为跟着官方文档学习不会走歪路

Next.js 支持多种为应用程序添加样式的方法，包括：

CSS Modules：创建局部作用域的 CSS 类，避免命名冲突并提高可维护性。
全局 CSS：使用简单，对于有传统 CSS 经验的人来说很熟悉，但可能导致 CSS 包体积较大，且随着应用程序增长难以管理样式。
Tailwind CSS：一个实用优先的 CSS 框架，通过组合实用类可以快速创建自定义设计。
CSS预处理器：比如Sass，通过变量、嵌套规则和混合等特性扩展了 CSS 功能。
CSS-in-JS：直接在 JavaScript 组件中嵌入 CSS，实现动态和作用域样式。

一：CSS Modules 和全局CSS

CSS Modules 通过自动创建唯一的类名来实现 CSS 的局部作用域。这使得你可以在不同文件中使用相同的类名而不用担心冲突。这种特性使 CSS Modules 成为引入组件级 CSS 的理想方式。

Next.js 内置支持使用 .module.css 扩展名的 CSS Modules。
在这里插入图片描述
CSS Modules 仅对扩展名为 .module.css 和 .module.sass 的文件启用。

在生产环境中，所有 CSS Module 文件会自动合并成多个经过代码分割和压缩的 .css 文件。这些 .css 文件代表了应用程序中的热执行路径，确保只加载应用程序渲染所需的最少 CSS。

而全局样式可以在 app 目录下的任何布局、页面或组件中导入，例如在根布局 (app/layout.js) 中，导入 global.css 样式表以将样式应用到应用程序的每个路由。

Next.js 在生产构建期间通过自动分块（合并）样式表来优化 CSS。CSS 的顺序是由_你在应用程序代码中导入样式表的顺序_决定的。因此官方建议：

只在单个 JS/TS 文件中导入一个 CSS 文件。
如果使用全局类名，在同一个文件中按照你想要应用的顺序导入全局样式。
优先使用 CSS Modules 而不是全局样式。
为你的 CSS modules 使用一致的命名约定。例如，使用·<name>.module.css 而不是 <name>.tsx。
将共享样式提取到单独的共享组件中。
如果使用 Tailwind，最好在文件顶部导入样式表，最好是在根布局中。
关闭任何会自动对导入进行排序的 linters/formatters（例如，ESLint 的 sort-import）

你可以使用 next.config.js 中的 cssChunking 选项来控制 CSS 如何分块。

const nextConfig = {experimental: {cssChunking: 'loose', // 默认值},
}

‘loose’ (默认值)：Next.js 会尽可能合并 CSS 文件，通过导入顺序确定文件之间的显式和隐式依赖关系，以减少分块数量，从而减少请求数量。
‘strict’：Next.js 将按照文件中导入的正确顺序加载 CSS 文件，这可能会导致更多的分块和请求。(遇到意外的 CSS 行为时使用)

二：Tailwind CSS

创建新的 Next.js 应用程序，可以选择使用Tailwind CSS，它会为你自动设置好。
或者手动添加,，通过以下命令安装并生成tailwind.config.js 和 postcss.config.js 文件。

npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init -p

在tailwind.config.ts可以添加将使用 Tailwind 类名的文件路径。
你不需要修改 postcss.config.js。

可以将 Tailwind 用于注入其生成样式的 Tailwind CSS 指令添加到应用程序中的全局样式表中，例如：

@tailwind base;
@tailwind components;
@tailwind utilities;

三：CSS预处理器

Next.js 在安装相关包后，内置支持使用 .scss 和 .sass 扩展名集成 Sass。你可以通过 CSS Modules 使用组件级的 Sass，使用 .module.scss 或 .module.sass 扩展名。
首先安装

npm install --save-dev sass

如果你想配置 Sass 选项，可以在 next.config 中使用 sassOptions。
Sass 有不同的实现方式，最常用的有两种：

Node Sass：基于 LibSass 的实现，使用 C++ 编写，性能较高，但已经不再维护。
Dart Sass：基于 Dart 语言的实现，是 Sass 官方推荐的实现，支持最新的 Sass 特性。
默认情况下，Next.js 使用 sass 包，即Dart Sass

Next.js 支持从 CSS Module 文件导出 Sass 变量。

例如，使用导出的 primaryColor Sass 变量：
在这里插入图片描述

四：CSS-in-JS

CSS-in-JS 是一种将 CSS 样式与 JavaScript 代码结合的方式，允许在组件内定义样式。

需要运行时 JavaScript 的 CSS-in-JS 库目前不支持在服务器组件中使用。在新的 React 特性（如服务器组件和流式传输）中使用 CSS-in-JS，需要库作者支持最新版本的 React，包括并发渲染。
以下库支持在 app 目录中的客户端组件中使用（按字母顺序排列）：

ant-design
chakra-ui
@fluentui/react-components
kuma-ui
@mui/material
@mui/joy
pandacss
styled-jsx
styled-components
stylex
tamagui
tss-react
vanilla-extract

如果你想为服务器组件添加样式，官方推荐使用 CSS Modules 或其他输出 CSS 文件的解决方案，如 PostCSS 或 Tailwind CSS

配置 CSS-in-JS 是一个三步的选择性过程，包括：

一个样式注册表用于收集渲染中的所有 CSS 规则。
新的 useServerInsertedHTML hook，用于在可能使用这些规则的任何内容之前注入规则。
一个客户端组件，在初始服务器端渲染期间用样式注册表包装你的应用。

以styled-jsx（v5.1.0 或更高版本）为例
首先，创建一个新的注册表：

"use client";import React, { useState } from "react";
import { useServerInsertedHTML } from "next/navigation";
import { StyleRegistry, createStyleRegistry } from "styled-jsx";export default function StyledJsxRegistry({children,
}: {children: React.ReactNode;
}) {// 只创建一次样式表，使用延迟初始状态// x-ref: https://reactjs.org/docs/hooks-reference.html#lazy-initial-stateconst [jsxStyleRegistry] = useState(() => createStyleRegistry());useServerInsertedHTML(() => {const styles = jsxStyleRegistry.styles();jsxStyleRegistry.flush();return <>{styles}</>;});return <StyleRegistry registry={jsxStyleRegistry}>{children}</StyleRegistry>;
}

然后，用注册表包装你的根布局

import StyledJsxRegistry from "./registry";export default function RootLayout({children,
}: {children: React.ReactNode;
}) {return (<html><body><StyledJsxRegistry>{children}</StyledJsxRegistry></body></html>);
}

在这里查看示例

Next.js-样式处理

一：CSS Modules 和全局CSS

二：Tailwind CSS

三：CSS预处理器

四：CSS-in-JS

相关文章：