无JVM/Docker环境下基于OpenAPI3.0.2生成Swagger离线文档

针对你的需求，以下是几个符合约束的离线单文件API文档生成方案：

方案1：纯Python生态实现（推荐，适配你的Python3.9环境） #

完全基于Python工具链，无需JVM/Docker，生成的单文件HTML/PDF无任何外部依赖：

1. 安装依赖库

   pip install swagger-ui-py weasyprint
   

2. 生成单文件离线HTML文档
   创建Python脚本generate_docs.py：

   from swagger_ui import render_swagger_ui
   
   # 读取本地OpenAPI 3.0.2 JSON文件
   with open("openapi.json", "r", encoding="utf-8") as f:
       openapi_spec = f.read()
   
   # 生成离线单文件HTML，内嵌所有CSS/JS资源
   render_swagger_ui(
       api_spec=openapi_spec,
       output_path="api-docs.html",
       offline=True,
       title="API离线文档"
   )
   

   执行脚本：

   python generate_docs.py
   

   生成的api-docs.html是完全独立的文件，打开后和SwaggerUI界面一致，包含所有端点、HTTP状态码、响应Schema及示例，无需任何在线资源。

3. （可选）转换为PDF格式
   在上述脚本基础上添加：

   from weasyprint import HTML
   
   HTML("api-docs.html").write_pdf("api-docs.pdf")
   

   执行后生成的PDF可直接离线阅读，无外部依赖。

方案2：使用Redoc CLI生成单文件HTML（需Node.js环境） #

若允许安装轻量的Node.js，可生成样式简洁的离线单文件HTML，再转为PDF：

1. 安装Node.js后，安装Redoc CLI：

   npm install -g redoc-cli
   

2. 生成单文件离线HTML：

   redoc-cli bundle openapi.json --output api-docs.html
   

   该命令会将所有CSS/JS资源内嵌到HTML中，无任何外部链接。

3. （可选）转为PDF：
   使用本地Chrome/Edge浏览器的无头模式：

   chrome --headless --print-to-pdf=api-docs.pdf api-docs.html
   

   或使用wkhtmltopdf工具转换，均无需在线资源。

方案3：生成PDF/docx文档（需Pandoc） #

通过Markdown中转，生成标准的PDF或docx单文件：

1. 安装Pandoc（跨平台轻量工具，无JVM/Docker依赖）。

2. 将OpenAPI JSON转为Markdown：
   若使用Python工具：

   pip install openapi-markdown
   openapi-markdown openapi.json > api-docs.md
   

   生成的Markdown包含所有API细节。

3. 转换为PDF/docx：

   # 转PDF
   pandoc api-docs.md -o api-docs.pdf
   # 转docx
   pandoc api-docs.md -o api-docs.docx
   

   生成的文件均为独立单文件，无需额外工具即可阅读。

内容的提问来源于stack exchange，提问作者shined day