标签：api文档

09 NestJS 使用 @nestjs-swagger 生成 API 文档

前言在前后端分离的项目中，API 文档是前后端协作的核心契约。手动维护文档不仅繁琐，还容易与代码脱节。@nestjs/swagger 基于 OpenAPI 规范，通过装饰器直接从代码生成交互式 API 文档，做到了文档即代码。本文基于 @nestjs/swagger v8（NestJS v10/v11），覆盖从基础配置到生产级最佳实践的完整流程。[hide]安装pnpm add @nestjs/swagger一、基础配置（main.ts）在 main.ts 中初始化 Swagger，这是所有配置的起点。// src/main.ts import { NestFactory } from ...