背景介绍
在前后端分离的项目开发过程中,如果后端同学能够提供一份清晰明了的接口文档,那么就能极大地提高大家的沟通效率和开发效率。可是编写接口文档历来都是令人头痛的,而且后续接口文档的维护也十分耗费精力。
最好是有一种方案能够既满足我们输出文档的需要又能随代码的变更自动更新,而Swagger正是那种能帮我们解决接口文档问题的工具。
安装swagger
go install github.com/swaggo/swag/cmd/swag@latest
查看版本
swag -v
swag.exe version v1.16.3
LeftDelim 问题解决
go Swagger生成文档时 LeftDelim: “{{“,RightDelim: “}}“,问题
版本分支查看
原因:最新版本导致,安装旧版本可以解决
go install github.com/swaggo/swag/cmd/swag@v1.8.12