跳转到内容
搜索文档

构建缓存

最后更新 查看 MarkdownAgent 设置

通过在构建之间缓存依赖和构建输出,利用项目级共享缓存缩短 Pages 构建时间。

在 Pages 项目上启用构建缓存后,首次构建将写入缓存。除非另行配置,后续每次构建都会从缓存恢复。

关于构建缓存

启用后,构建缓存会自动检测并缓存每次构建的数据。请参阅 框架 了解哪些目录会自动保存并从构建缓存中恢复。

要求

构建缓存需要 V2 构建系统 或更高版本。若要从 V1 升级,请参阅 V2 构建系统迁移说明

包管理器

Pages 将缓存以下包管理器的全局缓存目录:

包管理器 缓存的目录
npm .npm
yarn .cache/yarn
pnpm .pnpm-store
bun .bun/install/cache

框架

部分框架提供缓存目录,构建时通常由框架填充中间构建输出或依赖。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。若项目缓存超出此限制,将自动删除最近最少读取的工件。

启用构建缓存

要启用构建缓存:

  1. 在 Cloudflare 仪表板中,前往 Workers & Pages 页面。

    Go to Workers & Pages ↗
  2. 找到你的 Pages 项目。

  3. 前往 Settings(设置) > Build > Build cache

  4. 选择 Enable(启用) 开启构建缓存。

清除构建缓存

必要时可清除项目的构建缓存,例如调试构建问题时。要清除构建缓存:

  1. 在 Cloudflare 仪表板中,前往 Workers & Pages 页面。

    Go to Workers & Pages ↗
  2. 找到你的 Pages 项目。

  3. 前往 Settings(设置) > Build > Build cache

  4. 选择 Clear Cache(清除缓存) 清除构建缓存。

这篇文档对您有帮助吗?