☰ 菜单
命令行 开源 26 次安装/月

swag for Mac 版

swag

使用 Swagger 2.0 为 Go 自动生成 RESTful API 文档

swag 是什么

swag 是一个把 Go 代码注释转换成 Swagger 2.0 文档的工具。它针对 Gin、Echo、Fiber、net/http、chi 等主流 Go Web 框架提供了插件,让已有项目能较快接入 Swagger UI。

使用时,开发者只需在 API 源码里按声明式注释格式写说明,再运行 `swag init`,工具就会解析注释并生成 docs 目录和 docs/docs.go。生成的文档包需要被导入,相关配置才会生效;如果通用 API 注释不在 main.go 里,可以用 `-g` 参数指定位置。它还提供 `swag fmt` 命令,用来格式化 Swag 注释。

这个工具解决的是 Go 项目 API 文档与代码脱节的问题:注释即文档,减少手工维护。它适合使用 Go 开发 Web 服务、希望快速生成 Swagger 文档并接入 Swagger UI 的开发者,尤其是已经使用上述框架、想低成本补上接口文档的团队。

如何安装 swag

  1. 打开 终端(按 ⌘ + 空格,输入“终端”)。
  2. 如果还没安装 Homebrew,先运行下面这条安装命令。
  3. 运行下面这条命令:

最近 10 个版本记录

最近一次更新为 2026-09-13,当前版本 v2.0.0-rc6,共记录最近 10 个版本。

版本发布日期类型大小macOSWindowsLinux
v2.0.0-rc62026-09-13稳定版4.5 MB下载—下载
v2.0.0-rc52026-01-09稳定版8.2 MB下载—下载
v1.16.62025-07-29稳定版8.1 MB下载—下载
v1.16.52025-07-17稳定版8.1 MB下载—下载
v2.0.0-rc42024-11-30稳定版4.7 MB下载—下载
v1.16.42024-10-18稳定版4.2 MB下载—下载
v1.16.32024-02-01稳定版3.8 MB下载下载下载
v1.16.22023-08-30稳定版4.0 MB下载—下载
v2.0.0-rc32023-05-04稳定版————
v2.0.0-rc22023-04-18稳定版————

数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。

二进制包支持平台

Homebrew 官方提供的预编译包(bottle)覆盖:

  • Apple 芯片 · 最新 macOS
  • Apple 芯片 · macOS 26 Tahoe
  • Apple 芯片 · macOS 15 Sequoia
  • Apple 芯片 · macOS 14 Sonoma
  • Intel · macOS 14 Sonoma
  • Linux · ARM64
  • Linux · x86_64

与同类应用对比

只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。

与同类应用对比
应用版本许可证架构近 30 天安装
swagv2.0.0-rc6MIT命令行26
rbtools7.0MIT命令行25
wuppiefuzzv1.8.1Apache-2.0命令行12
libnfclibnfc-1.8.0LGPL-3.0-or-later命令行69

开发工具中的类似应用

发表评论

电子邮件地址不会被公开。必填项已用 * 标注。