Linux下Swagger如何实现API文档的离线查看

在Linux下，要实现Swagger API文档的离线查看，你可以按照以下步骤操作：

1. 首先，确保你已经安装了Java和Maven。如果没有，请访问以下链接进行安装：

   • Java: https://www.oracle.com/java/technologies/javase-jdk14-downloads.html
   • Maven: https://maven.apache.org/download.cgi

2. 克隆Swagger UI的GitHub仓库：

   git clone https://github.com/swagger-api/swagger-ui.git
   

3. 进入swagger-ui目录：

   cd swagger-ui
   

4. 安装依赖：

   mvn clean install
   

5. 构建项目：

   mvn -DskipTests package
   

6. 构建完成后，你会在swagger-ui/target目录下找到一个名为swagger-ui-standalone-preset.zip的文件。这个文件包含了Swagger UI的所有资源，包括CSS、JavaScript和API文档。

7. 解压swagger-ui-standalone-preset.zip文件到一个合适的目录，例如/opt/swagger-ui：

   sudo unzip swagger-ui-standalone-preset.zip -d /opt/swagger-ui
   

8. 现在，你可以使用一个简单的HTTP服务器来运行Swagger UI。进入/opt/swagger-ui/swagger-ui-dist目录，然后使用Python 3启动HTTP服务器：

   cd /opt/swagger-ui/swagger-ui-dist
   python3 -m http.server 8080
   

9. 打开浏览器，访问http://localhost:8080，你应该可以看到Swagger UI界面。在这里，你可以浏览和查看API文档。

10. 若要查看特定API文档，你可以将API文档（通常是YAML或JSON格式）放到/opt/swagger-ui/swagger-ui-dist/swagger.json文件的位置，并在Swagger UI界面中选择该文件。

现在你已经成功实现了在Linux下Swagger API文档的离线查看。