如果对使用swagger接口文档比较感兴趣可以参考此章节介绍，不需要的话可以忽略该章节。

swagger接口文档主要用于前后端的接口定义。Golang的swagger文档通过注释的形式编写到api层的代码中，使得接口文档可以随着代码一起维护，降低代码与文档不一致的风险，并通过gf-cli工具生成：swagger API文档生成。

`swagger`编写

swagger的语法请参考第三方仓库swag：https://github.com/swaggo/swag

目前仅此一家Golang Swagger组件库，Golang的swagger编写体验并不是特别友好，聊胜于无吧。

`swagger`生成

我们这里使用以下命令生成：

gf swagger --pack

其中gf swagger命令解析并生成swagger.json文档到项目根目录的swagger路径下，同时这里的--pack选项将swagger.json打包为Golang代码文件生成到项目根目录的packed路径下。

具体请参考 swagger API文档生成章节。

我们这里使用到了GoFrame的swagger插件：https://github.com/gogf/swagger

按照仓库介绍说明，我们在boot启动设置模块中添加插件的注册：

随后可以启动程序访问查看swagger接口文档页面：http://127.0.0.1:8199/swagger

Content Menu