turbopackPluginRuntimeStrategy
experimental
选择 Turbopack 如何为 webpack loaders、Babel 和 PostCSS 运行 Node.js 求值。
experimental.turbopackPluginRuntimeStrategy 选项选择 Turbopack 是在子进程还是 worker 线程中运行 Node.js 求值。
next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
turbopackPluginRuntimeStrategy: 'workerThreads',
},
}
export default nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
turbopackPluginRuntimeStrategy: 'workerThreads',
},
}
module.exports = nextConfig此运行时执行基于 Node.js 的工具,包括 webpack loaders、Babel 和 PostCSS。
参考#
| 值 | 默认值 | 描述 |
|---|---|---|
'childProcesses' | 是 | 在子进程池中运行 Node.js 求值,并通过 socket 与它们通信。 |
'workerThreads' | 否 | 在 Next.js 进程内的 worker 线程中运行 Node.js 求值。与子进程池相比,这可以减少内存和 CPU 开销。 |
'forceWorkerThreads' | 否 | 即使当前 Node.js 版本受到下述 worker 线程拆除问题的影响,也使用 worker 线程。这可能导致进程中止。 |
Node.js 兼容性#
在 Node.js 24.13.1 及更高版本上,当 worker 退出时,如果原生插件具有活动的 Node-API 线程安全函数,Node.js worker 线程拆除问题可能导致进程中止。
当在受影响的 Node.js 版本上将 turbopackPluginRuntimeStrategy 设置为 'workerThreads' 时,Next.js 会打印警告并回退到 'childProcesses'。设置 'forceWorkerThreads' 可绕过回退,但可能导致进程中止。
版本历史#
| 版本 | 变更 |
|---|---|
v16.4.0 | 添加了 experimental.turbopackPluginRuntimeStrategy 配置选项。 |