🎉 我只想go开发有一个好用一点不丑的Swagger文档

38 阅读1分钟

🎉 青峰 Swagger v1.3.0 更新了

一个美观、强大的 Swagger UI 替代方案,专为 Go Gin 框架设计

✨ 这次更新带来了什么?

🌍 多环境一键切换

终于不用改代码切环境了!配置好开发、测试、生产环境,顶部下拉框一键切换。

Environments: []qingfeng.Environment{
    {Name: "本地开发", BaseURL: "http://localhost:8080/api"},
    {Name: "测试环境", BaseURL: "https://test-api.example.com/api"},
    {Name: "生产环境", BaseURL: "https://api.example.com/api"},
}

📝 请求体模板

调试接口时,常用的请求体可以保存为模板,下次一键加载,告别重复输入!

📋 复制 cURL 命令

一键复制 cURL,直接粘贴到终端调试,分享给同事也方便。

🔄 响应体增强

  • 格式化/压缩一键切换
  • 查看完整响应头
  • 大响应自动折叠
  • 显示响应体大小

✅ 体验细节优化

  • 必填参数校验,发送前自动检查
  • 请求中按钮禁用,防止重复点击
  • 分组折叠状态记忆
  • 调试数据持久化(切换接口不丢失)

📱 移动端完美适配

手机上也能愉快地调试接口了!


🚀 一行代码接入

go get github.com/wdcbot/qingfeng@latest
r.GET("/doc/*any", qingfeng.Handler(qingfeng.Config{
    Title:    "我的 API",
    BasePath: "/doc",
    DocPath:  "./docs/swagger.json",
}))

访问 /doc/ 即可看到效果!


📸 效果预览

桌面端移动端
桌面端移动端

🔗 链接


如果觉得有用,欢迎 ⭐ Star 支持一下!

#Go #Golang #Swagger #API #开源