Next.js Pages Router(旧版) 是做什么的?
优先级:P0(关键)
[!IMPORTANT] 项目使用的是 Next.js Pages Router(
pages/目录)。请勿使用 App Router 的特性。
实现指南
- 路由架构:使用
pages/目录。通过_app.tsx实现全局状态/布局,_document.tsx自定义 HTML 属性。使用 方括号[id].tsx或 通配符[...slug].tsx定义动态路由。 - 数据获取(SSR/SSG):使用
getServerSideProps(每次请求时执行)或getStaticProps(构建时执行),动态路由配合getStaticPaths。将这些函数导出为独立的async函数。 - 逻辑隔离:绝不在服务端钩子中
fetch自己的/api端点。应直接导入服务层或数据库逻辑。 - 客户端钩子:从
next/router导入useRouter()进行导航和访问查询参数。使用router.push()或<Link>进行客户端路由。 - API:在
pages/api/中实现API 路由,用于服务端专用逻辑或 Webhook。使用适当的 HTTP 状态码标准化响应。 - Next.js 15+ 兼容性:注意 Next.js 15 升级,确保所有
getServerSideProps返回的对象与预期的PageProps匹配。 - 样式:通过 CSS Modules(
*.module.css) 或 Tailwind CSS 进行标准化。除非在_app.tsx中导入,否则避免使用全局 CSS。