swaggo

Issues somebody may already be working on are listed last. List everything by date

• @Router 无法解析包含中文等 Unicode 字符的路径

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 5/5 Over a week Newbie friendliness 38/100

  swaggo/swag#2229 · Opened Oct 12, 2026

• Why not support openapi 3.x

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 5/5 Over a week Newbie friendliness 10/100

  swaggo/swag#2218 · 2 comments · 1 reaction · Opened Aug 26, 2026

• [Go 1.27] Support generic methods (methods declaring their own type parameters)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  swaggo/swag#2215 · 1 comment · 5 reactions · Opened Aug 23, 2026

• v2: every @Param body request body wrapped in a spurious 2-branch oneOf with a $ref sibling

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 55/100

  swaggo/swag#2197 · 1 comment · 3 reactions · Opened Jul 14, 2026

• v2: empty externalDocs.url emitted when no @externalDocs annotation is present

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 70/100

  swaggo/swag#2196 · Opened Jul 14, 2026

• v2 --v3.1: leftover OpenAPI 2.0 fields (schemes, host, basePath) in the output

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 55/100

  swaggo/swag#2194 · 1 reaction · Opened Jul 14, 2026

• Support `QUERY` http method

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 62/100

  swaggo/swag#2193 · 1 comment · Opened Jul 11, 2026

• cannot find type definition: gin.H

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 50/100

  swaggo/swag#2179 · 3 comments · Opened Jun 23, 2026

• Code Health Audit — 449 findings

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 Over a week Newbie friendliness 20/100

  swaggo/swag#2176 · Opened Jun 13, 2026

• multi server config

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 Under an hour Newbie friendliness 45/100

  swaggo/gin-swagger#330 · Opened Jun 8, 2026

• [V2] Support @Title annotation on struct types to emit schema title

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 70/100

  swaggo/swag#2171 · Opened May 8, 2026

• Support for external json-schema ref

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 65/100

  swaggo/swag#2165 · Opened May 4, 2026

• Swag fmt looks so wired

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 55/100

  swaggo/swag#2162 · 1 reaction · Opened Apr 29, 2026

• @Param does not generate arguments if complex type is specified

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 57/100

  swaggo/swag#2161 · 1 comment · Opened Apr 27, 2026

• v2: can't parse numeric value of "maximum" tag

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 70/100

  swaggo/swag#2153 · Opened Mar 15, 2026

• example/basic: route mismatch between main.go and @Router annotation for Upload

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 1/5 Under an hour Newbie friendliness 85/100

  swaggo/swag#2152 · 1 comment · Opened Mar 14, 2026

• @schemes annotation doesn't populate SwaggerInfo.Schemes in generated docs.go

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 65/100

  swaggo/swag#2143 · Opened Feb 12, 2026

• 枚举的注释生成了但没有显示

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 55/100

  swaggo/swag#2136 · Opened Jan 25, 2026

• description.markdown doesn't work for openapi v3.

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 45/100

  swaggo/swag#2129 · Opened Jan 5, 2026

• When will Swag support generic responses?

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  swaggo/swag#2122 · Opened Dec 22, 2025

• Inline does not work together with replace

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  swaggo/swag#2121 · Opened Dec 22, 2025

• Has any plan to release new version for swag/v2?

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 5/5 Over a week Newbie friendliness 20/100

  swaggo/swag#2119 · 3 comments · Opened Dec 19, 2025

• Generation panic on custom string

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 45/100

  swaggo/swag#2114 · Opened Dec 11, 2025

• how to use swag example tag for array samples

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 35/100

  swaggo/swag#2107 · Opened Nov 30, 2025

• Goland. Warning Missing required property 'version'

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 70/100

  swaggo/swag#2106 · Opened Nov 26, 2025

• How to exclude fields with json tags when documenting query parameters?

  May be free again @nohy6630 claimed this 277 days ago, and no pull request is open. Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 55/100

  swaggo/swag#2096 · 3 comments · Opened Nov 15, 2025

• Why did my anti-virus software detect a Trojan virus in your official package?

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 Over a week Newbie friendliness 35/100

  swaggo/gin-swagger#325 · Opened Nov 6, 2025

• Request body as parameter

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 35/100

  swaggo/swag#2091 · Opened Nov 1, 2025

• `swag fmt` fails in Docker image: "go command required, not found"

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 62/100

  swaggo/swag#2088 · 1 comment · Opened Oct 29, 2025

• Request body param always generate `oneOf`, and incorrectly (v2)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  swaggo/swag#2086 · 1 comment · 8 reactions · Opened Oct 27, 2025

• How to describe a non-empty field without intruding on the code?

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 Under an hour Newbie friendliness 35/100

  swaggo/swag#2084 · Opened Oct 15, 2025

• swag fmt: Skip detection for generated files

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 50/100

  swaggo/swag#2081 · 2 comments · Opened Oct 9, 2025

• Crash (segmentation violation) on Generic Struct of enum array

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 55/100

  swaggo/swag#2080 · Opened Oct 7, 2025

• Enumeration Type Generation Exception

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 35/100

  swaggo/swag#2079 · Opened Sep 27, 2025

• Generation panic on custom type

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 45/100

  swaggo/swag#2078 · 3 reactions · Opened Sep 26, 2025

• can support dynamic filed ???

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 40/100

  swaggo/swag#2076 · 1 comment · Opened Sep 18, 2025

• Enable adding custom extensions in the swagger's info section

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 70/100

  swaggo/swag#2073 · 5 reactions · Opened Sep 15, 2025

• Generated file header is non-conventional

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 45/100

  swaggo/swag#2071 · Opened Sep 8, 2025

• `allOf` with `required` support per request

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 65/100

  swaggo/swag#2070 · Opened Sep 5, 2025

• swag init --v3.1 generated invalid requsetBody

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  swaggo/swag#2062 · 2 comments · 2 reactions · Opened Aug 25, 2025

• `swag fmt` fails to format annotations correctly unless there’s a blank line before the function

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 65/100

  swaggo/swag#2045 · 8 comments · 1 reaction · Opened Jul 18, 2025

• `@host` and `@BasePath` annotations not being recognized when `swag init`

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 55/100

  swaggo/swag#2037 · 3 comments · 2 reactions · Opened Jul 9, 2025

• parse.go parseTypeExpr解析结构体panic异常

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 50/100

  swaggo/swag#2036 · 1 comment · Opened Jul 6, 2025

• support gen `x-enum-comments` from comment above enum variable

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 42/100

  swaggo/swag#2034 · Opened Jul 3, 2025

• Repeated tab insertion on `swag fmt`

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  swaggo/swag#2028 · 4 reactions · Opened Jun 24, 2025

• How to exit on error?

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  Difficulty 2/5 1-3 hours Newbie friendliness 70/100

  swaggo/swag#2024 · 1 comment · Opened Jun 6, 2025

• Support for Annotations

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 5/5 Over a week Newbie friendliness 20/100

  swaggo/swag#2023 · Opened Jun 2, 2025

• Failed to load API definition - Internal Server Error doc.json

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 34/100

  swaggo/gin-swagger#321 · 1 comment · Opened May 16, 2025

• extension:"x-order" not working with flag --v3.1

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 50/100

  swaggo/swag#2020 · 2 reactions · Opened May 15, 2025

• Integration of the swag formatter inside golangci-lint

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 1/5 Under an hour Newbie friendliness 15/100

  swaggo/swag#2017 · 3 reactions · Opened May 4, 2025