SuperAPI AI 工具集

nextjs-app-router-patterns

前端与建站

查看项目

更新于 10-15 21:38

技能介绍

用途:为 Next.js 14+ App Router 架构、服务端组件与现代全栈 React 开发提供实践模式,覆盖新建应用、从 Pages Router 迁移、流式渲染、并行与拦截路由、数据获取与缓存优化及 Server Actions 全栈功能。

主要能力:区分渲染模式及适用场景——服务端组件(仅服务端,用于数据获取、重计算、密钥)、客户端组件(浏览器,用于交互、hooks、浏览器 API)、静态(构建时,内容少变)、动态(请求时,个性化或实时数据)、流式(渐进式,大页面或慢数据源)。说明文件约定,如 app/ 下 layout.tsx、page.tsx、loading.tsx、error.tsx、not-found.tsx、route.ts、template.tsx、default.tsx、opengraph-image.tsx 各自作用。

使用方式:以 app/layout.tsx 定义根布局与 metadata,配合 Providers 包裹;app/page.tsx 默认即服务端组件,可直接 async 获取数据。fetch 支持 next.revalidate 实现 ISR,例如 next: { revalidate: 3600 }。更多详细模式与示例保存在 references/details.md,导航层不足时阅读该文件。

最佳实践:从服务端组件开始,仅在需要时加 'use client';就近放置数据获取;用 Suspense 边界实现流式;利用并行路由获得独立加载状态;用 Server Actions 处理变更并支持渐进增强。避免:在服务端到客户端边界传递不可序列化数据;在服务端组件使用 useState、useEffect 等 hooks;在客户端组件获取数据(改用服务端组件或 React Query);过度嵌套布局;忽略加载状态,应始终提供 loading.tsx 或 Suspense。

限制:资料未提供具体收费、价格、平台支持范围或效果数据,相关内容暂未提供。