swag for Mac 版
使用 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 的开发者,尤其是已经使用上述框架、想低成本补上接口文档的团队。
使用时,开发者只需在 API 源码里按声明式注释格式写说明,再运行 `swag init`,工具就会解析注释并生成 docs 目录和 docs/docs.go。生成的文档包需要被导入,相关配置才会生效;如果通用 API 注释不在 main.go 里,可以用 `-g` 参数指定位置。它还提供 `swag fmt` 命令,用来格式化 Swag 注释。
这个工具解决的是 Go 项目 API 文档与代码脱节的问题:注释即文档,减少手工维护。它适合使用 Go 开发 Web 服务、希望快速生成 Swagger 文档并接入 Swagger UI 的开发者,尤其是已经使用上述框架、想低成本补上接口文档的团队。
如何安装 swag
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-09-13,当前版本 v2.0.0-rc6,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v2.0.0-rc6 | 2026-09-13 | 稳定版 | 4.5 MB | 下载 | — | 下载 |
| v2.0.0-rc5 | 2026-01-09 | 稳定版 | 8.2 MB | 下载 | — | 下载 |
| v1.16.6 | 2025-07-29 | 稳定版 | 8.1 MB | 下载 | — | 下载 |
| v1.16.5 | 2025-07-17 | 稳定版 | 8.1 MB | 下载 | — | 下载 |
| v2.0.0-rc4 | 2024-11-30 | 稳定版 | 4.7 MB | 下载 | — | 下载 |
| v1.16.4 | 2024-10-18 | 稳定版 | 4.2 MB | 下载 | — | 下载 |
| v1.16.3 | 2024-02-01 | 稳定版 | 3.8 MB | 下载 | 下载 | 下载 |
| v1.16.2 | 2023-08-30 | 稳定版 | 4.0 MB | 下载 | — | 下载 |
| v2.0.0-rc3 | 2023-05-04 | 稳定版 | — | — | — | — |
| v2.0.0-rc2 | 2023-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 天安装 |
|---|---|---|---|---|
| swag | v2.0.0-rc6 | MIT | 命令行 | 26 |
| rbtools | 7.0 | MIT | 命令行 | 25 |
| wuppiefuzz | v1.8.1 | Apache-2.0 | 命令行 | 12 |
| libnfc | libnfc-1.8.0 | LGPL-3.0-or-later | 命令行 | 69 |