swag

swag 是一个为 Go 语言项目自动生成 Swagger 2.0（OpenAPI 2.0）RESTful API 文档的工具。它通过解析 Go 源码中的结构体注释和路由注解，无需手动编写 YAML/JSON，即可生成符合规范的 API 文档，并支持集成 Swagger UI 实时预览。核心特点包括轻量无运行时依赖、兼容主流 Go Web 框架（如 Gin、Echo、Beego）、支持模型定义、参数描述、安全配置及响应示例等。适用于需要快速同步维护 API 文档的 Go 后端服务开发与团队协作场景。