如何在Next.js项目中集成Swagger文档？
摘要：Next.js 本来就不能直接用 Swagger，非要用还得自己折腾 API Routes？自动生成工具？手动写 Spec？这简直是在侮辱开发者。手动注释？这操作简直是在挑战耐心极限。
前言
最近一直在用 Next.js 开发我的新网站
这次写了一些 API
我就想着能不能像平时开发后端那样，使用 swagger 进行调试
所以进行了一番调研
严格来说 Next.js 本身并不直接支持 swagger，因为 swagger（更准确地说是 OpenAPI 规范）是后端 API 文档的工具，而 Next.js 是一个前端/全栈框架。
不过，如果用 Next.js 的 API Routes（即 app/api/* 目录下的接口），完全可以结合 swagger 来做 API 文档。