通过在构建之间缓存依赖和构建输出,利用项目级共享缓存缩短 Pages 构建时间。
在 Pages 项目上启用构建缓存后,首次构建将写入缓存。除非另行配置,后续每次构建都会从缓存恢复。
启用后,构建缓存会自动检测并缓存每次构建的数据。请参阅 框架 了解哪些目录会自动保存并从构建缓存中恢复。
构建缓存需要 V2 构建系统 或更高版本。若要从 V1 升级,请参阅 V2 构建系统迁移说明。
Pages 将缓存以下包管理器的全局缓存目录:
部分框架提供缓存目录,构建时通常由框架填充中间构建输出或依赖。Pages 会自动检测你使用的框架并缓存该目录,供后续构建复用。
以下框架支持构建输出缓存:
| 框架 | 缓存的目录 |
|---|---|
| Astro | node_modules/.astro |
| Docusaurus | node_modules/.cache, .docusaurus, build |
| Eleventy | .cache |
| Gatsby | .cache, public |
| Hugo | .cache |
| Next.js | .next/cache |
| Nuxt | node_modules/.cache/nuxt |
| SvelteKit | node_modules/.cache/imagetools |
构建缓存适用以下限制:
- 保留期:缓存自上次读取日期起七天后清除。未读取的缓存工件自创建起七天后清除。
- 存储:每个项目分配 10 GB。若项目缓存超出此限制,将自动删除最近最少读取的工件。
要启用构建缓存:
-
在 Cloudflare 仪表板中,前往 Workers & Pages 页面。
Go to Workers & Pages ↗ -
找到你的 Pages 项目。
-
前往 Settings(设置) > Build > Build cache。
-
选择 Enable(启用) 开启构建缓存。
必要时可清除项目的构建缓存,例如调试构建问题时。要清除构建缓存:
-
在 Cloudflare 仪表板中,前往 Workers & Pages 页面。
Go to Workers & Pages ↗ -
找到你的 Pages 项目。
-
前往 Settings(设置) > Build > Build cache。
-
选择 Clear Cache(清除缓存) 清除构建缓存。