NNext.js 中文网 GitHub

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 nextConfig
next.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 配置选项。
Next.js 中文网