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 nextConfignext.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.0 | Beta 版本,为构建和开发提供独立的标志 |
v15.5.0 | 持久化缓存作为实验性功能在 canary 版本中发布 |