antst

go-apispec

antst

一个从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 文档生成的团队

快速上手

  1. 安装:go install github.com/antst/go-apispec/cmd/apispec@latest
  2. 生成:apispec --dir ./your-project --output openapi.yaml

核心优势

  • 零注解,从真实代码生成
  • 自动检测框架和路由
  • 多框架同时支持
  • 类型感知的响应推断

历史版本

排序