Owner

swaggo

登录后关注

已索引 2 个仓库 · 在 GitHub 查看

swag
Automatically generate RESTful API documentation with Swagger 2.0 for Go.

Go · 13040 个 star
gin-swagger
gin middleware to automatically generate RESTful API documentation with Swagger 2.0.

Go · 4239 个 star

适合新手全部

未关闭全部

可能已有人在做的 issue 排在最后。全部按时间排序

Why not support openapi 3.x
未关闭
- 哪里不对？
难度 5/5 一周以上新手友好度 10/100

swaggo/swag#2218 · 2 条评论 · 1 个 reaction · 2026年8月26日创建
[Go 1.27] Support generic methods (methods declaring their own type parameters)
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 45/100

swaggo/swag#2215 · 1 条评论 · 5 个 reaction · 2026年8月23日创建
v2: every @Param body request body wrapped in a spurious 2-branch oneOf with a $ref sibling
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 55/100

swaggo/swag#2197 · 1 条评论 · 3 个 reaction · 2026年7月14日创建
v2: empty externalDocs.url emitted when no @externalDocs annotation is present
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 70/100

swaggo/swag#2196 · 2026年7月14日创建
v2 --v3.1: leftover OpenAPI 2.0 fields (schemes, host, basePath) in the output
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 55/100

swaggo/swag#2194 · 2026年7月14日创建
Support `QUERY` http method
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 62/100

swaggo/swag#2193 · 1 条评论 · 2026年7月11日创建
cannot find type definition: gin.H
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 50/100

swaggo/swag#2179 · 3 条评论 · 2026年6月23日创建
Code Health Audit — 449 findings
未关闭
- 哪里不对？
难度 4/5 一周以上新手友好度 20/100

swaggo/swag#2176 · 2026年6月13日创建
multi server config
未关闭
- 哪里不对？
难度 2/5 1 小时以内新手友好度 45/100

swaggo/gin-swagger#330 · 2026年6月8日创建
[V2] Support @Title annotation on struct types to emit schema title
未关闭
- 哪里不对？
难度 3/5 半天新手友好度 70/100

swaggo/swag#2171 · 2026年5月8日创建
Support for external json-schema ref
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 65/100

swaggo/swag#2165 · 2026年5月4日创建
Swag fmt looks so wired
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 55/100

swaggo/swag#2162 · 1 个 reaction · 2026年4月29日创建
@Param does not generate arguments if complex type is specified
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 57/100

swaggo/swag#2161 · 1 条评论 · 2026年4月27日创建
v2: can't parse numeric value of "maximum" tag
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 70/100

swaggo/swag#2153 · 2026年3月15日创建
example/basic: route mismatch between main.go and @Router annotation for Upload
未关闭
- 哪里不对？
难度 1/5 1 小时以内新手友好度 85/100

swaggo/swag#2152 · 1 条评论 · 2026年3月14日创建
@schemes annotation doesn't populate SwaggerInfo.Schemes in generated docs.go
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 65/100

swaggo/swag#2143 · 2026年2月12日创建
枚举的注释生成了但没有显示
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 55/100

swaggo/swag#2136 · 2026年1月25日创建
description.markdown doesn't work for openapi v3.
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 45/100

swaggo/swag#2129 · 2026年1月5日创建
When will Swag support generic responses?
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 45/100

swaggo/swag#2122 · 2025年12月22日创建
Inline does not work together with replace
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 45/100

swaggo/swag#2121 · 2025年12月22日创建
Has any plan to release new version for swag/v2?
未关闭
- 哪里不对？
难度 5/5 一周以上新手友好度 20/100

swaggo/swag#2119 · 3 条评论 · 2025年12月19日创建
Generation panic on custom string
未关闭
- 哪里不对？
难度 3/5 半天新手友好度 45/100

swaggo/swag#2114 · 2025年12月11日创建
how to use swag example tag for array samples
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 35/100

swaggo/swag#2107 · 2025年11月30日创建
Goland. Warning Missing required property 'version'
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 70/100

swaggo/swag#2106 · 2025年11月26日创建
How to exclude fields with json tags when documenting query parameters?
可能重新可做 @nohy6630 于 275 天前认领，目前没有进行中的 PR。未关闭
- 哪里不对？
难度 3/5 半天新手友好度 55/100

swaggo/swag#2096 · 3 条评论 · 2025年11月15日创建
Why did my anti-virus software detect a Trojan virus in your official package?
未关闭
- 哪里不对？
难度 4/5 一周以上新手友好度 35/100

swaggo/gin-swagger#325 · 2025年11月6日创建
Request body as parameter
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 35/100

swaggo/swag#2091 · 2025年11月1日创建
`swag fmt` fails in Docker image: "go command required, not found"
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 62/100

swaggo/swag#2088 · 1 条评论 · 2025年10月29日创建
Request body param always generate `oneOf`, and incorrectly (v2)
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 45/100

swaggo/swag#2086 · 1 条评论 · 8 个 reaction · 2025年10月27日创建
How to describe a non-empty field without intruding on the code?
未关闭
- 哪里不对？
难度 2/5 1 小时以内新手友好度 35/100

swaggo/swag#2084 · 2025年10月15日创建
swag fmt: Skip detection for generated files
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 50/100

swaggo/swag#2081 · 2 条评论 · 2025年10月9日创建
Crash (segmentation violation) on Generic Struct of enum array
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 55/100

swaggo/swag#2080 · 2025年10月7日创建
Enumeration Type Generation Exception
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 35/100

swaggo/swag#2079 · 2025年9月27日创建
Generation panic on custom type
未关闭
- 哪里不对？
难度 3/5 半天新手友好度 45/100

swaggo/swag#2078 · 3 个 reaction · 2025年9月26日创建
can support dynamic filed ???
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 40/100

swaggo/swag#2076 · 1 条评论 · 2025年9月18日创建
Enable adding custom extensions in the swagger's info section
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 70/100

swaggo/swag#2073 · 5 个 reaction · 2025年9月15日创建
Generated file header is non-conventional
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 45/100

swaggo/swag#2071 · 2025年9月8日创建
`allOf` with `required` support per request
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 65/100

swaggo/swag#2070 · 2025年9月5日创建
swag init --v3.1 generated invalid requsetBody
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 45/100

swaggo/swag#2062 · 2 条评论 · 2 个 reaction · 2025年8月25日创建
`swag fmt` fails to format annotations correctly unless there’s a blank line before the function
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 65/100

swaggo/swag#2045 · 8 条评论 · 1 个 reaction · 2025年7月18日创建
`@host` and `@BasePath` annotations not being recognized when `swag init`
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 55/100

swaggo/swag#2037 · 3 条评论 · 2 个 reaction · 2025年7月9日创建
parse.go parseTypeExpr解析结构体panic异常
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 50/100

swaggo/swag#2036 · 1 条评论 · 2025年7月6日创建
support gen `x-enum-comments` from comment above enum variable
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 42/100

swaggo/swag#2034 · 2025年7月3日创建
Repeated tab insertion on `swag fmt`
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 45/100

swaggo/swag#2028 · 4 个 reaction · 2025年6月24日创建
How to exit on error?
未关闭
- 哪里不对？
enhancement

难度 2/5 1-3 小时新手友好度 70/100

swaggo/swag#2024 · 1 条评论 · 2025年6月6日创建
Support for Annotations
未关闭
- 哪里不对？
难度 5/5 一周以上新手友好度 20/100

swaggo/swag#2023 · 2025年6月2日创建
Failed to load API definition - Internal Server Error doc.json
未关闭
- 哪里不对？
难度 3/5 1-2 天新手友好度 34/100

swaggo/gin-swagger#321 · 1 条评论 · 2025年5月16日创建
extension:"x-order" not working with flag --v3.1
未关闭
- 哪里不对？
难度 2/5 1-3 小时新手友好度 50/100

swaggo/swag#2020 · 2 个 reaction · 2025年5月15日创建
Integration of the swag formatter inside golangci-lint
未关闭
- 哪里不对？
难度 1/5 1 小时以内新手友好度 15/100

swaggo/swag#2017 · 3 个 reaction · 2025年5月4日创建
Using import alias in struct would show cannot find type definition
未关闭
- 哪里不对？
难度 2/5 1 小时以内新手友好度 70/100

swaggo/swag#2016 · 1 条评论 · 1 个 reaction · 2025年5月1日创建

只显示最新的 100 条

这个页面只列出最近收录的部分。完整清单在高级筛选里，可以按语言、难度和预计耗时筛选。

前往高级筛选

swaggo

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

哪里不对？

只显示最新的 100 条

把新 issue 发到你的邮箱