跳至内容

cssChunking

此 API 目前处于实验阶段,可能会发生变化。

CSS 分块是一种用于通过拆分和重新排序 CSS 文件到块中来提高 Web 应用程序性能的策略。这使您可以仅加载特定路由所需的 CSS,而不是一次加载所有应用程序的 CSS。

您可以使用 next.config.js 文件中的 experimental.cssChunking 选项来控制 CSS 文件的分块方式。

next.config.ts
import type { NextConfig } from 'next'
 
const nextConfig = {
  experimental: {
    cssChunking: 'loose', // default
  },
} satisfies NextConfig
 
export default nextConfig

选项

  • 'loose'(默认):Next.js 会尽可能地合并 CSS 文件,根据文件导入顺序确定显式和隐式依赖关系,以减少块的数量,从而减少请求次数。
  • 'strict':Next.js 将按照文件导入的正确顺序加载 CSS 文件,这可能导致更多的块和请求。

如果您遇到意外的 CSS 行为,可以考虑使用 'strict'。例如,如果您在不同的文件中使用不同的 import 顺序导入 a.cssb.cssab 之前,或 ba 之前),'loose' 将以任何顺序合并文件,并假设它们之间没有依赖关系。但是,如果 b.css 依赖于 a.css,您可能希望使用 'strict' 来防止文件合并,而是按照导入的顺序加载它们,这可能导致更多的块和请求。

对于大多数应用程序,我们建议使用 'loose',因为它可以减少请求次数并提高性能。