NNext.js 中文网 GitHub

turbopackGc

experimental

配置 Turbopack 从内存和持久缓存中移除无法访问的工作。

experimental.turbopackGc 选项控制 Turbopack 内存缓存和持久缓存的垃圾回收。垃圾回收默认启用。要禁用它,请将该选项设置为 false:

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

const nextConfig: NextConfig = {
  experimental: {
    turbopackGc: false,
  },
}

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

module.exports = nextConfig

参考#

turbopackGc 默认值为 true,可接受布尔值或对象:

值说明
false禁用垃圾回收。
true使用默认时序启用垃圾回收。
{ minProgressMs?, rootTtlMs? }启用垃圾回收并覆盖一个或多个默认时序。

启用后,Turbopack 会从内存及其持久缓存中移除无法访问的工作。当 next dev 和 next build 使用 Turbopack 时,该选项对它们都适用。

小知识:

选项#

对象形式接受以下属性:

属性类型默认值说明
minProgressMs非负 number100垃圾回收过程在响应中断之前运行的最短时间。
rootTtlMs非负 number259200000(3 天)垃圾回收根在 Turbopack 移除它之前可以保持无锚定状态的时间。

以下配置让垃圾回收过程在让出之前至少运行 200 毫秒,并在一天后使无锚定的根过期:

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

const nextConfig: NextConfig = {
  experimental: {
    turbopackGc: {
      minProgressMs: 200,
      rootTtlMs: 24 * 60 * 60 * 1000,
    },
  },
}

export default nextConfig
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    turbopackGc: {
      minProgressMs: 200,
      rootTtlMs: 24 * 60 * 60 * 1000,
    },
  },
}

module.exports = nextConfig

版本历史#

版本变更
v16.5.0experimental.turbopackGc 默认启用。
v16.4.0新增 experimental.turbopackGc 配置选项。
Next.js 中文网