go install github.com/go-openapi/swag

swag init

//go:build doc
// +build doc

/**
* 注意条件编译注释 //go:build doc 只能出现在代码文件的最顶部(这是Go 1.17的新的条件编译语法),不建议再使用//+build doc 旧的条件编译语法
*/
package routers

import (
\_ "demo/docs"
swaggerFiles "github.com/swaggo/files"
ginSwagger "github.com/swaggo/gin-swagger"
)

func init() {
swagHandler = ginSwagger.WrapHandler(swaggerFiles.Handler)
}

package routers

import (
"github.com/gin-gonic/gin"
)

var swagHandler gin.HandlerFunc

func InitRouter() \*gin.Engine {

router := gin.New()

// api group 的路由
api := router.Group("/api")

api.Use(gin.Logger())
api.GET("/users", GetUserList)

if swagHandler != nil {
router.GET("/swagger/\*any", swagHandler)
}
return router

}

package main

import (

"flag"
"fmt"
"demo/routers"
)

func main() {

var name = ""

var host = "0.0.0.0"

var port int

flag.StringVar(&name, "s", "Gin", "service name")

flag.StringVar(&host, "h", "0.0.0.0", "host")

flag.IntVar(&port, "p", 8080, "port")

flag.Parse()
flag.Usage()

router := routers.InitRouter()

// // 支持静态文件及路径
// staticDir := "web"
// router.StaticFS("/static", http.Dir(staticDir))
// router.StaticFS("/doc", http.Dir("doc"))

fmt.Printf("[%s] listening on %s:%d\n", name, host, port)

// url := ginSwagger.URL(fmt.Sprintf("/swagger/doc.json")) // The url pointing to API definition
// // swagger group 的路由
// router.GET("/swagger/\*any", ginSwagger.WrapHandler(swaggerFiles.Handler, url))
router.Run(fmt.Sprintf("%s:%d", host, port))
}

go run -tags=doc .

go build -tags=doc .

go run .

go build .