turbopackGc
experimental
配置 Turbopack 从内存和持久缓存中移除无法访问的工作。
experimental.turbopackGc 选项控制 Turbopack 内存缓存和持久缓存的垃圾回收。垃圾回收默认启用。要禁用它,请将该选项设置为 false:
next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
turbopackGc: false,
},
}
export default nextConfignext.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 时,该选项对它们都适用。
小知识:
- 垃圾回收需要 Turbopack FileSystem Cache。当当前命令禁用了缓存时,该选项不起作用。
- 在长时间运行的读写会话中,当
turbopackMemoryEviction设置为false时,Turbopack 会禁用垃圾回收。
选项#
对象形式接受以下属性:
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
minProgressMs | 非负 number | 100 | 垃圾回收过程在响应中断之前运行的最短时间。 |
rootTtlMs | 非负 number | 259200000(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 nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
turbopackGc: {
minProgressMs: 200,
rootTtlMs: 24 * 60 * 60 * 1000,
},
},
}
module.exports = nextConfig版本历史#
| 版本 | 变更 |
|---|---|
v16.5.0 | experimental.turbopackGc 默认启用。 |
v16.4.0 | 新增 experimental.turbopackGc 配置选项。 |