nextjs-cache-components-runtime

Next.js Cache Components 运行时

当任务会改变 Next.js 路由的预渲染、流式传输、缓存、个性化或失效方式时，请使用此技能。明确标示缓存边界，不要依赖旧版路由级动态／静态标记。

适用场景

以下情况请使用此技能：

• 启用或调试 cacheComponents: true
• 添加 use cache、cacheLife、cacheTag、updateTag 或 revalidateTag
• 修复“未缓存的数据位于 Suspense 外部”这类构建／运行时错误
• 将 cookies()、headers()、params 或 searchParams 等运行时 API 传递给缓存函数
• 将 dynamic、revalidate 或旧版缓存代码迁移至 Cache Components
• 为可自托管或无服务器部署设计缓存行为

按需加载

从此文件开始。仅在任务需要时加载详细文件：

references/_sections.md
references/cache-use-cache-scope.md
references/cache-runtime-suspense.md
references/cache-tag-invalidation.md
references/cache-remote-cache.md
references/cache-metadata-runtime.md
references/cache-migration-segment-configs.md
dataset/cache/use-cache-scope/correct.tsx
sources/inventory.json

每个规则文件都包含：

• 该模式的重要性
• 错误与正确示例
• 包含更大型 TypeScript/TSX 示例的数据集路径
• 官方来源参考

按优先级划分的规则类别

优先级	类别	影响	前缀
1	缓存边界	严重	cache-
2	数据与运行时渲染	高	data-
3	运维与部署	高	ops-

来源政策

Cache Components 相关内容请使用 Next.js 16 官方文档。除非项目尚未启用 cacheComponents，否则不要依赖 Next.js 13/14/15 的缓存建议。