Next.js 开发规范
给出 Next.js App Router 的代码或架构问题,产出符合官方最佳实践的写法与对应的检查要点。
功能与用途
写或评审 Next.js 代码时,最容易出错的地方是服务端与客户端组件的边界、数据获取方式和缓存策略。这个能力把官方最佳实践拆成路由约定、RSC 边界、异步 API、运行时选择、指令、路由处理器、元数据、图片与字体优化、打包、水合错误、Suspense 边界、并行与拦截路由、自托管等主题,逐项给出参考文档与改法,还包含用 MCP 端点和 --debug-build-paths 做调试的技巧。
适用场景
- App Router 架构与边界规范:检查服务端与客户端组件边界,规避非序列化 props 与非法异步客户端组件错误。
- 性能与资源加载优化:按规范配置 next/image、next/font 以及静态元数据,优化核心 Web 性能指标。
- 水合错误与路由异常排查:定位浏览器 API 错用引起的水合失败,并规范 Suspense 边界与并行拦截路由写法。
适用人群
- 用 App Router 写 Next.js 的前端开发
- 做 Next.js 代码评审的技术负责人
- 要从 Pages Router 迁到 App Router 的工程师
使用步骤
- 把 Next.js 相关文件或报错现象发过去,说明是路由、数据获取、缓存还是渲染问题
- 让它按主题定位到对应规则,比如 RSC 边界、异步 params、指令或缓存句柄
- 拿到具体的改法:文件该放哪、加什么指令、哪些函数要 await、需要包哪层 Suspense
- 按建议改完跑 next build 与 next dev,确认构建错误和水合警告消失
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Next.js App Router expert guidance. Use when building, debugging, or architecting Next.js applications — routing, Server Components, Server Actions, Cache Components, layouts, middleware/proxy, data fetching, rendering strategies, and deployment on Vercel.
使用前准备
- 有一个 Next.js 项目(App Router 或 Pages Router),能本地跑 next dev/build
依赖与权限
- 读取用户主动提供的内容