[TOC] > [github](https://github.com/go-swagger/go-swagger) ## 概述 * 从 swagger 规范生成服务器 * 从 swagger 规范生成客户端 * 从 swagger 规范（alpha 阶段）生成 CLI（命令行工具） * 支持 jsonschema 和 swagger 提供的大部分功能，包括多态性 * 从带注释的 go 代码生成一个 swagger 规范 * 使用 swagger 规范的其他工具 * 强大的自定义功能，带有供应商扩展和可自定义的模板 go-swagger 解析不关心注释写在哪里,通过扫描生成 swagger.yaml 配置文件 ## 安装 源码安装 ``` git clone https://github.com/go-swagger/go-swagger cd go-swagger go install ./cmd/swagger ``` ## 命令 ``` Application Options: /q, /quiet silence logs /log-output:LOG-FILE redirect logs to file Help Options: /? Show this help message /h, /help Show this help message Available commands: diff diff swagger documents expand expand $ref fields in a swagger spec flatten flattens a swagger document generate generate go code init initialize a spec document mixin merge swagger documents serve serve spec and docs validate validate the swagger document version print the version ``` 示例: 1. 生成 配置文件 ``` swagger generate spec -o swagger.json ``` 2. 创建服务 ``` swagger -F [redoc|swagger] swagger.json ``` redoc和swagger为两种风格