NNext.js 中文网 GitHub

turbopackLocalPostcssConfig

在 Turbopack 中启用按目录解析 PostCSS 配置,使最接近每个 CSS 文件的配置优先于项目根目录的配置。

turbopackLocalPostcssConfig 选项改变了 Turbopack 解析 postcss.config.js 文件的方式。启用后,Turbopack 会先从 CSS 文件所在的目录开始查找配置,然后再回退到项目根目录。默认情况下,Turbopack 会先检查项目根目录,这意味着根目录的 postcss.config.js 始终优先于子目录中的配置。

此选项仅在使用 Turbopack(next dev 或 next build)时相关。

用法#

next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    turbopackLocalPostcssConfig: true,
  },
}

export default nextConfig
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    turbopackLocalPostcssConfig: true,
  },
}

module.exports = nextConfig

行为#

设置配置解析顺序
false(默认)项目根目录 → CSS 文件所在目录
trueCSS 文件所在目录 → 项目根目录

在默认行为下,项目根目录的 postcss.config.js 会用于所有 CSS 文件,而按目录的配置仅在不存在根目录配置时才会应用。启用 turbopackLocalPostcssConfig 后情况相反:按目录的配置优先,根目录配置作为回退。

示例#

这适用于需要在不同目录中使用不同 PostCSS 转换的项目,例如包含多个应用或设计系统包的 monorepo:

text
my-app/
├── postcss.config.js          ← 回退配置(未找到本地配置时应用)
├── app/
│   └── page.module.css        ← 使用根目录配置
└── packages/
    └── ui/
        ├── postcss.config.js  ← 对该目录中的文件优先
        └── button.module.css  ← 使用 packages/ui/postcss.config.js

版本历史#

版本变更
v16.3.0引入 turbopackLocalPostcssConfig。
Next.js 中文网