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 nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
turbopackLocalPostcssConfig: true,
},
}
module.exports = nextConfig行为#
| 设置 | 配置解析顺序 |
|---|---|
false(默认) | 项目根目录 → CSS 文件所在目录 |
true | CSS 文件所在目录 → 项目根目录 |
在默认行为下,项目根目录的 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。 |