AI Skill 大全

Next静态缓存组件

给 Next.js 16 项目的页面或数据函数配置缓存:写 use cache 指令、设 cacheLife 生命周期、用 cacheTag 打标签做失效,并把旧的 unstable_cache 迁移过来。

功能与用途

Next.js 16 的 Cache Components 把静态、缓存、动态三种内容混在同一条路由里,做部分预渲染(PPR)。写之前得先搞清哪些能缓存、cookies 和 headers 为什么不能在 use cache 里用、缓存键是怎么拼出来的,很容易踩坑。它给出开开关、三种内容类型、缓存指令粒度、生命周期配置、标签失效和旧 API 迁移的完整对照与代码示例。

适用场景

  • 页面部分预渲染(PPR):在单一路由中混合静态外壳、缓存数据与 Suspense 流式动态块,提升首屏响应。
  • 函数与组件级精细缓存:为复杂查询标记 use cache 指令,并配置 cacheLife 周期或自定义过期规则。
  • 按需精准失效与旧版迁移:使用 cacheTag 标记数据并在变更后即时刷新,或把旧版 unstable_cache 逻辑迁移重构。

适用人群

  • 用 Next.js App Router 做高流量页面的前端开发
  • 正在从 Next 14/15 升级到 16 的工程师
  • 为内容站点优化首屏与缓存策略的技术负责人

使用步骤

  1. 在 next.config.ts 里打开 cacheComponents: true(它会取代老的 experimental.ppr)。
  2. 判断每块内容属于哪一类:同步代码和纯计算是静态、异步但不用每次刷新的加 'use cache'、必须实时的用 Suspense 包起来。
  3. 按需要选缓存的粒度,文件级、组件级或函数级;再用 cacheLife 配生命周期(内置 default/minutes/hours/days/weeks/max,或内联写 stale/revalidate/expire)。
  4. 给缓存内容打 cacheTag,更新数据时用 updateTag 做同请求内立即失效,或用 revalidateTag 做后台失效。
  5. 检查 use cache 里有没有 cookies()、headers() 或 searchParams,有的话把它们提到外面当参数传进去(合规场景可用 use cache: private),最后按迁移对照表替换旧配置。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
专业
版本
main
最近更新
2026-09-18
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Next.js 16 Cache Components guidance — PPR, use cache directive, cacheLife, cacheTag, updateTag, and migration from unstable_cache. Use when implementing partial prerendering, caching strategies, or migrating from older Next.js cache patterns.

使用前准备

  • 需要 Next.js 16+ 项目与 TypeScript 环境,理解 App Router、RSC 与 Suspense 的工作方式,最好能跑 next dev / next build 验证

依赖与权限

  • 读取用户主动提供的内容

同类 Skill