v2 --v3.1: 输出中的剩余 OpenAPI 2.0 字段 (方案、主机、基路径)
作者: ahridin创建于 2026年7月14日更新于 2026年7月14日
swag 版本: v2.0.0-rc5 命令: swag init --v3.1 ...
使用 --v3.1 运行 swag init 仍会在文档根目录中输出 schemes、host 和 basePath。这些是 Swagger 2.0 专用的键 — OpenAPI 3.x 将它们替换为 servers。它们的存在不会破坏严格的验证器,但与其他方面的 3.1 文档不一致,并且会混淆那些通过字段存在而非 openapi 关键字来识别版本的内容。
内容来源: swaggo/swag