[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為兩種風格