Linux Swagger如何更新版本

在 Linux 环境下更新 Swagger（通常指 Swagger UI / Swagger Editor / Swagger Codegen / OpenAPI Tools），方式取决于你当前使用的形式。下面按常见场景分别说明。

一、如果你用的是 Swagger UI（最常见）

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

1. 查看当前版本（可选）

ls swagger-ui

2. 下载最新版

wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.17.14.tar.gz

⚠️ 版本号请替换为 GitHub 最新 release： https://github.com/swagger-api/swagger-ui/releases

3. 解压

tar -zxvf v5.17.14.tar.gz

4. 替换旧目录

cp -r swagger-ui-5.17.14/dist/* /your/nginx/or/web/path/

✅ 方式 2：通过 git 更新（开发环境）

cd swagger-ui
git pull origin master
npm install
npm run build

适用于自己编译 Swagger UI 的情况

二、如果你用的是 Swagger Editor

更新方式

wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v4.16.1.tar.gz
tar -zxvf v4.16.1.tar.gz

或直接拉最新 Docker 镜像（推荐）：

docker pull swaggerapi/swagger-editor

三、如果你用的是 Docker 部署的 Swagger

查看当前版本

docker images | grep swagger

更新到最新版

docker pull swaggerapi/swagger-ui
docker pull swaggerapi/swagger-editor

重启容器

docker stop swagger-ui
docker rm swagger-ui
docker run -d -p 8080:8080 --name swagger-ui swaggerapi/swagger-ui

四、如果你用的是 Swagger Codegen / OpenAPI Generator

Swagger Codegen（旧）

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

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

五、如果你是通过 npm 安装的 Swagger UI

npm outdated swagger-ui
npm install swagger-ui@latest

或全局：

npm update -g swagger-ui

六、更新后建议检查

• ✅ 页面是否能正常打开
• ✅ OpenAPI / Swagger 版本是否兼容
• ✅ 接口文档是否报错

七、快速判断你该用哪种方式

如果你愿意，可以告诉我：

• ✅ 你用的是 Swagger UI / Editor / Codegen
• ✅ 是 Docker / Nginx / 本地部署
• ✅ Linux 发行版（Ubuntu / CentOS / 其他）

我可以给你精确到命令级别的更新方案。