swag v2 support generate openapi v3.1 docs, but gin-swagger not support.
I referred to the design of gin-swagger and simplified the use of gin-swagger.
Now just copy the following two files to your project:
openapi/register.go
openapi/swagger-initializer.js
In this way you can make some custom modifications according to the needs of the project.
-
install swag v2
go install github.com/swaggo/swag/v2/cmd/swag@latest -
generate openapi v3.1 docs
swag init --v3.1 --output ./openapi --outputTypes jsongenerated
openapi/swagger.jsonfile, and ignored by.gitignorenot push to git repo. -
run app
go run main.go -
view docs open http://localhost:8080/openapi in browser.
Enjoy!