前言

在前后端分离的项目中，API 文档是前后端协作的核心契约。手动维护文档不仅繁琐，还容易与代码脱节。@nestjs/swagger 基于 OpenAPI 规范，通过装饰器直接从代码生成交互式 API 文档，做到了文档即代码。

本文基于 @nestjs/swagger v8（NestJS v10/v11），覆盖从基础配置到生产级最佳实践的完整流程。

---

此处内容已隐藏回复后方可阅读。