用途:在 Next.js Pages Router(旧版路由,pages/ 目录)项目中实现数据获取、路由与 API 逻辑,明确不使用 App Router 的功能。
主要能力与用法: 路由架构:使用 pages/ 目录;用 _app.tsx 管理全局状态与布局,用 _document.tsx 定制 HTML 属性;动态路由用 [id].tsx 或兜底路由 [...slug].tsx。 数据获取:服务端渲染用 getServerSideProps(每次请求),静态生成用 getStaticProps(构建时)并在动态路由中配合 getStaticPaths;这些应作为独立异步函数导出。类型可用 InferGetServerSidePropsType<typeof getServerSideProps> 标注 props。 逻辑隔离:不要在服务端钩子中调用本项目的 /api 路由,应直接导入服务层或数据库逻辑。 客户端钩子:导航与查询参数用 next/router 的 useRouter(),客户端跳转用 router.push() 或 <Link>。 API:在 pages/api/ 中实现仅服务端逻辑或 webhook,并使用合适的 HTTP 状态码规范响应。 样式:使用 CSS Modules(*.module.css)或 Tailwind CSS,除在 _app.tsx 外避免全局 CSS。
限制与注意:避免在 Pages Router 项目中使用 App Router 特性;Next.js 15+ 升级时需确保 getServerSideProps 返回对象与 PageProps 匹配。资料未提供具体安装命令、收费与平台信息。