Ubuntu上Swagger（OpenAPI）支持的格式主要分为 配置文件格式、API文档生成格式 及 响应数据展示格式 三大类，覆盖了API开发、文档化及测试的全流程需求。
一、配置文件格式（定义API规范）
Swagger的核心配置文件（用于描述API路径、参数、响应等结构）主要支持两种轻量级格式：
- JSON格式：遵循OpenAPI规范的JSON结构，是早期主流的配置格式，适用于需要严格遵循JSON语法的场景。例如，一个简单的用户API配置文件可能包含
swagger版本、info信息、paths路径定义等内容。
- YAML格式：更简洁、易读的格式，支持注释（JSON不支持），是当前推荐的配置格式。YAML文件通过缩进表示层级关系，例如同样的用户API配置可使用
swagger: '2.0'、info:、paths:等关键字组织内容。
二、API文档生成格式（输出文档类型）
Swagger可根据配置生成多种格式的API文档，满足不同场景的展示需求：
- HTML格式：通过Swagger UI生成的交互式网页文档，支持实时测试接口（如“Try it out”功能）、搜索过滤及响应展示，是最常用的文档形式。
- JSON/YAML格式：生成的原始规范文件，可用于其他工具（如代码生成器）或团队协作，确保文档与代码的一致性。
- XML格式：适用于需要与XML-based系统集成的场景，生成的XML文档包含API的路径、参数、响应等信息。
三、响应数据展示格式（Swagger UI中的测试结果）
Swagger UI的“Try it out”功能支持测试API并展示多种格式的响应数据，提升调试效率：
- JSON/XML/HTML/纯文本：JSON数据会语法高亮、自动格式化并支持下载；XML数据会美化输出；HTML数据会语法高亮；纯文本数据直接显示原始内容。
- CSV：表格化展示CSV格式的响应数据，便于查看结构化表格信息。
- 二进制文件：自动触发下载链接，显示文件类型（如PDF、图片）及大小信息。
- 图片/音频：内嵌显示常见图片格式（如JPEG、PNG）或通过音频播放器播放音频文件。
以上格式覆盖了Swagger在Ubuntu上的主要使用场景，从配置定义到文档生成再到接口测试，均能满足开发者的需求。
