一个从Go源码生成OpenAPI 3.1规范的静态分析工具,零注解,自动检测框架,支持Chi、Gin、Echo、Fiber、Gorilla Mux和net/http。
- v0.4.25
- 发布于
- 2026年6月18日
- 39
- 星标
- 12
- 下载
- 同步于
- 10 天前
最新版本
v0.4.252026年6月18日 02:26下载慢?可在上方随时切换镜像源
项目说明
项目概述
go-apispec 分析 Go 源码并生成 OpenAPI 3.1 规范(YAML 或 JSON),零注解,自动检测框架,从路由到处理器跟踪调用图。
主要功能
- 框架支持:Chi、Gin、Echo、Fiber、Gorilla Mux、net/http
- 响应检测:从实际代码推断 Content-Type、状态码和响应 Schema
- 多框架同时支持:项目中同时使用多个框架时,所有路由都会出现在规范中
- 路径参数归一化:自动处理各框架的路径参数语法差异
- 错误辅助函数跟踪:通过参数映射跟踪错误辅助函数的调用
适用人群
- Go API 开发者
- 需要自动化 OpenAPI 文档生成的团队
快速上手
- 安装:
go install github.com/antst/go-apispec/cmd/apispec@latest - 生成:
apispec --dir ./your-project --output openapi.yaml
核心优势
- 零注解,从真实代码生成
- 自动检测框架和路由
- 多框架同时支持
- 类型感知的响应推断
历史版本
排序