# 安装swag
go get -u github.com/swaggo/swag/cmd/swag

# 安装 gin-swagger

go get -u github.com/swaggo/gin-swagger

go get -u github.com/swaggo/gin-swagger/swaggerFiles

// @Summary 新增文章标签

// @Produce  json

// @Param name query string true "Name"

// @Param state query int false "State"

// @Param created_by query string false "CreatedBy"

// @Success 200 {object} app.Response

// @Success 500 {object} app.Response

// @Router /api/tags [post]

func AddTag(c *gin.Context) {

...

}

// @Summary 编辑文章标签

// @Produce  json

// @Param id path int true "ID"

// @Param name query string true "Name"

// @Param state query int false "State"

// @Param modified_by query string false "ModifiedBy"

// @Success 200 {object} app.Response

// @Success 500 {object} app.Response

// @Router /api/tags/{id} [put]

func EditTag(c *gin.Context) {

...

}

package routers

import (

    ...

    _ "your_module_name/docs"

    ...

)

// InitRouter initialize routing information

func InitRouter() *gin.Engine {

    ...

    r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))

    ...

    return r

}

swag init