Swagger在Linux如何更新

在 Linux 上“更新 Swagger”通常指 更新 Swagger UI / Swagger Editor / Swagger Codegen / OpenAPI 工具。不同场景更新方式不一样，下面按最常见情况给你一个清晰对照。

一、先确认你用的是哪种 Swagger

先搞清楚你当前环境里是哪一种：

which swagger
swagger version

或查看页面标题（浏览器里）：

Swagger UI
Swagger Editor
Swagger Codegen
OpenAPI Generator

二、更新 Swagger UI（最常见 ✅）

✅ 方式 1：直接下载最新版（推荐）

# 下载最新 release
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.17.14.zip

# 解压
unzip v5.17.14.zip

然后替换你项目中的 swagger-ui 目录：

cp -r swagger-ui-5.17.14/dist/* /your/project/swagger-ui/

浏览器访问 /swagger-ui/index.html 即可

✅ 方式 2：Docker 方式（如果你用 Docker）

docker pull swaggerapi/swagger-ui:v5.17.14
docker stop swagger-ui
docker rm swagger-ui

docker run -d \
  --name swagger-ui \
  -p 8080:8080 \
  -e SWAGGER_JSON=/app/swagger.json \
  -v $(pwd):/app \
  swaggerapi/swagger-ui:v5.17.14

三、更新 Swagger Editor

Docker 方式（最干净）

docker pull swaggerapi/swagger-editor
docker run -d -p 8081:8080 swaggerapi/swagger-editor

浏览器访问：

http://localhost:8081

四、更新 Swagger Codegen（老项目）

⚠️ Swagger Codegen 已停止维护，建议迁移到 OpenAPI Generator

旧方式（不推荐）

wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.32/swagger-codegen-cli-2.4.32.jar

运行：

java -jar swagger-codegen-cli-2.4.32.jar version

五、更新为 OpenAPI Generator（✅ 推荐）

安装 / 更新

# 使用 SDKMAN（推荐）
sdk install openapi-generator

# 或更新
sdk update
sdk upgrade openapi-generator

或直接下载

wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.6.0/openapi-generator-cli-7.6.0.jar

运行：

java -jar openapi-generator-cli-7.6.0.jar version

六、Spring Boot 项目（含 Swagger）

如果你指的是 Springfox / springdoc-openapi：

✅ springdoc-openapi（推荐）

<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
  <version>2.5.0</version>
</dependency>

更新方式：

mvn clean package

七、快速判断你该用哪种

场景	更新方式
浏览器访问 Swagger 页面	更新 Swagger UI
编辑 OpenAPI 文档	更新 Swagger Editor
生成代码	使用 OpenAPI Generator
Spring Boot	更新 springdoc / springfox
Docker 部署	`docker pull`

八、我可以更精确帮你

你可以直接告诉我：

✅ Linux 发行版（Ubuntu / CentOS / Alpine）
✅ 使用方式（Docker / 本地 jar / Spring Boot / Nginx）
✅ 当前 Swagger 版本
✅ 报错信息（如果有）

我可以给你 一步一步的命令，直接复制执行 ✅