NNext.js 中文网 GitHub

Turbopack 内存逐出

了解如何控制 Turbopack 对持久缓存的内存逐出策略。

用法#

turbopackMemoryEviction 控制 Turbopack 在启用持久(FileSystem)缓存时是否回收内存。在 Turbopack 将其缓存快照写入磁盘后,它可以"逐出"这些数据的内存副本,并在需要时从磁盘重新加载。

目前有三个选项:

  • false:从不逐出。缓存数据会在进程的整个生命周期内保留在内存中。
  • 'auto'(默认):仅在自上次逐出以来分配了足够多的内存、使得逐出有价值时,才在快照之后进行逐出。它利用阈值和来自操作系统的内存压力反馈。
  • 'full':每次保存到磁盘时,都从内存中逐出所有可能的数据。

小知识: 此选项仅在启用 FileSystem Cache 的 next dev 会话中生效,因为逐出依赖于已经持久化到磁盘的数据。它是实验性功能,正在积极开发中。

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

const nextConfig: NextConfig = {
  experimental: {
    turbopackMemoryEviction: 'auto',
  },
}

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

module.exports = nextConfig

版本变更#

版本变更
v16.3.0turbopackMemoryEviction 作为实验性功能发布。
Next.js 中文网