温馨提示×

debian swagger支持哪些版本

小樊
50
2026-09-04 19:34:43
栏目: 智能运维

你提到的 “Debian Swagger” 可能是指 在 Debian 系统上运行的 Swagger 相关工具/生态,常见包括:

  • Swagger UI
  • Swagger Editor
  • Swagger Codegen
  • OpenAPI (Swagger) 规范版本

下面分别说明 支持的版本情况。


一、Swagger / OpenAPI 规范版本支持

Swagger 现在称为 OpenAPI Specification(OAS),版本支持如下:

名称 版本 说明
Swagger 1.x 1.0 / 1.1 / 1.2 已淘汰
Swagger 2.0 2.0 广泛使用
OpenAPI 3.0 3.0.0 / 3.0.1 / 3.0.2 / 3.0.3 当前主流
OpenAPI 3.1 3.1.0 最新,兼容 JSON Schema 2020-12

✅ Debian 上运行的 Swagger 工具普遍支持:

  • Swagger 2.0
  • OpenAPI 3.0.x
  • OpenAPI 3.1(新版本工具支持)

二、Debian 官方仓库中的 Swagger 相关版本

1️⃣ Debian 稳定版(如 Debian 11 / 12)

Debian 官方仓库中 没有直接叫 swagger 的包,但常见相关包有:

✅ swagger-codegen

apt show swagger-codegen

常见版本:

  • Debian 11 (Bullseye): 2.4.x
  • Debian 12 (Bookworm): 3.x

支持:

  • OpenAPI 2.0
  • OpenAPI 3.0

2️⃣ Swagger UI(通过 npm / docker)

Debian 本身不限制版本,常见运行方式:

使用 npm

npm install swagger-ui

支持版本:

  • Swagger UI v4 / v5
  • OpenAPI 2.0 / 3.0 / 3.1(v5 支持更好)

使用 Docker(推荐)

docker pull swaggerapi/swagger-ui

始终是最新版,支持最新 OpenAPI 规范。


三、语言层面的 Swagger 支持(Debian 上常见)

语言 常见库 支持版本
Java springdoc-openapi 3.0 / 3.1
Python fastapi / flask-restx 2.0 / 3.0
Go swag 2.0 / 3.0
Node.js swagger-jsdoc 2.0 / 3.0

四、总结一句话

在 Debian 上,Swagger / OpenAPI 工具普遍支持 Swagger 2.0、OpenAPI 3.0,新版本工具支持 OpenAPI 3.1;具体版本取决于你使用的 Swagger UI / Codegen / 框架版本,而非 Debian 本身限制。

如果你能补充说明:

  • 是 Debian 哪个版本
  • 用的是 Swagger UI / Codegen / 某个框架

我可以给你更精确的版本对应表。

0 踩