SuperAPI AI 工具集

next-best-practices

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:在编写或审查 Next.js 代码时应用一套最佳实践规则,涵盖文件约定、RSC 边界、异步 API、元数据、错误处理、路由处理器、图片与字体优化等主题,每个主题对应一份参考文档(如 file-conventions.md、rsc-boundaries.md、async-patterns.md 等)。\n\n主要能力与覆盖点:文件约定(项目结构、特殊文件、动态/捕获全部/分组路由段、并行与拦截路由、v16 中 middleware 更名为 proxy);RSC 边界(检测无效的服务端组件模式,如同步客户端组件、不可序列化 props、Server Action 异常);异步模式(Next.js 15+ 的 async params 与 searchParams、async cookies()/headers()、迁移 codemod);运行时选择(默认 Node.js,何时用 Edge);指令('use client'、'use server'、'use cache');函数(导航钩子 useRouter、usePathname、useSearchParams、useParams;服务端函数 cookies、headers、draftMode、after;生成函数 generateStaticParams、generateMetadata);错误处理(error.tsx、global-error.tsx、not-found.tsx、redirect、permanentRedirect、notFound、forbidden、unauthorized、unstable_rethrow);数据模式(服务端组件 vs Server Actions vs 路由处理器,避免数据瀑布,客户端组件取数);路由处理器(route.ts、GET 与 page.tsx 冲突、环境行为、何时使用);元数据与 OG 图片(静态/动态元数据、generateMetadata、next/og、基于文件的约定);图片优化(next/image、远程图片配置、响应式 sizes、模糊占位、LCP 优先加载);字体优化(next/font、Google 字体与本地字体、Tailwind 集成、预加载子集);打包(服务端不兼容包、CSS 导入、polyfill、ESM/CommonJS、包分析);脚本(next/script、内联脚本需 id、加载策略、@next/third-parties 的 Google Analytics);水合错误(常见原因与修复);Suspense 边界(useSearchParams、usePathname 的 CSR bailout);并行与拦截路由(@slot 模态、default.tsx、router.back());自托管(output: 'standalone'、多实例 ISR 缓存处理器);调试技巧(MCP 端点、--debug-build-paths 重建路由)。\n\n使用方式:作为技能规则在编写或审查 Next.js 代码时应用,具体规则需查阅对应参考文档;资料未提供具体安装命令或调用示例。\n\n适用场景:Next.js 项目的开发、代码审查与问题排查。\n\n限制:资料未提供版本之外的适用边界、收费或平台信息。