NNext.js 中文网 GitHub

Turbopack 文件系统缓存

了解如何为 Turbopack 构建启用和配置文件系统缓存

用法#

Turbopack 文件系统缓存让 Turbopack 能够减少 next dev 或 next build 命令之间的重复工作。启用后,Turbopack 会在多次运行之间在 .next 目录下保存和恢复数据,从而大幅加快后续构建和开发会话。

有两个选项控制缓存,一个用于 next dev,一个用于 next build。两者都默认启用:

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

const nextConfig: NextConfig = {
  experimental: {
    turbopackFileSystemCacheForDev: true,
    turbopackFileSystemCacheForBuild: true,
  },
}

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

module.exports = nextConfig

选项#

  • turbopackFileSystemCacheForDev(默认:true):将 next dev 的 Turbopack 工作成果缓存到 .next/dev/cache/turbopack。重启开发服务器时会复用之前的编译结果。
  • turbopackFileSystemCacheForBuild(默认:true):将 next build 的 Turbopack 工作成果缓存到 .next/cache/turbopack。后续构建会以热状态启动。请参阅构建环境。

将任一选项设为 false 即可选择退出。

构建环境#

构建缓存位于 .next/cache。只有在每次构建前恢复该目录时,构建才会更快。

  • 自托管构建:在多次构建之间复用同一工作目录。容器化构建从干净层开始,除非显式缓存或挂载,否则不会保留 .next/cache。
  • CI 服务商:为 .next/cache 配置构建缓存。

如果你的构建环境从不保留 .next/cache,请设置 turbopackFileSystemCacheForBuild: false,以跳过写入不会被读取的缓存。

版本历史#

版本变更
v16.3.0构建默认启用文件系统缓存
v16.1.0开发默认启用文件系统缓存
v16.0.0Beta 版本,为构建和开发提供独立的标志
v15.5.0持久化缓存作为实验性功能在 canary 版本中发布
Next.js 中文网