oasdiff for Mac 版
OpenAPI 差异和重大更改
oasdiff 是什么
oasdiff 是一个命令行工具,用来比较 OpenAPI 规范并检测其中的破坏性变更。它的核心能力是判断两次 API 定义之间哪些改动会影响现有客户端——比如字段被删、类型变更等,同时也能给出面向 API 消费者的可读变更日志。除了 `breaking` 和 `changelog`,它还提供 `diff` 输出完整差异(支持 html、json、markdown、yaml 等格式),以及 `summary` 做高层级统计。对单个规范,它可以做校验、把 OpenAPI 3.0 升级到最新 3.x、合并 allOf schema;在 Git 工作流中,还能针对改动过的规范逐一比对,或作为外部 diff 驱动让 `git log --patch` 直接渲染变更日志。它解决的是 API 演进过程中难以快速识别兼容性风险的问题,适合维护公开或内部 API 的后端开发者、API 平台团队,以及在 CI 中需要自动拦截破坏性变更的工程团队。工具可本地运行,也可通过 GitHub Action 或托管 PR 审查流程集成到 CI 中。
如何安装 oasdiff
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-11-08,当前版本 v1.37.0,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v1.37.0 | 2026-11-08 | 稳定版 | 13.2 MB | 下载 | 下载 | 下载 |
| v1.36.0 | 2026-11-07 | 稳定版 | 13.2 MB | 下载 | 下载 | 下载 |
| v1.35.0 | 2026-10-28 | 稳定版 | 13.0 MB | 下载 | 下载 | 下载 |
| v1.34.1 | 2026-10-21 | 稳定版 | 12.9 MB | 下载 | 下载 | 下载 |
| v1.34.0 | 2026-10-18 | 稳定版 | 12.9 MB | 下载 | 下载 | 下载 |
| v1.33.0 | 2026-10-01 | 稳定版 | 12.7 MB | 下载 | 下载 | 下载 |
| v1.35.0-rc.1 | 2026-10-26 | 预发布 | 12.9 MB | 下载 | 下载 | 下载 |
| v1.33.1-rc.2 | 2026-10-08 | 预发布 | 12.8 MB | 下载 | 下载 | 下载 |
| v1.33.1-rc.1 | 2026-10-07 | 预发布 | 12.7 MB | 下载 | 下载 | 下载 |
| v1.33.0-rc.1 | 2026-09-15 | 预发布 | 12.7 MB | 下载 | 下载 | 下载 |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Linux · ARM64
- Linux · x86_64
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| oasdiff | v1.37.0 | Apache-2.0 | 命令行 | 789 |
| xdelta | v3.2.2 | GPL-2.0-or-later | 命令行 | 483 |
| redocly-cli | 2.71.0 | MIT | 命令行 | 704 |
| gpatch | 2.8.1 | GPL-3.0-or-later | 命令行 | 792 |
命令行工具中的类似应用
xdelta
xdelta 3 是一个用 C 编写的库和命令行工具,基于 VCDIFF/RFC 3284 流实现增量压缩。redocly-cli
Redocly CLI 是一款围绕 OpenAPI 描述文件展开的命令行工具,核心思路是让 API 文档和周边产物跟着代码一起维护。gpatch
gpatch 是一个在命令行里使用的补丁应用工具,主要用来把补丁文件合并到原始文件中。vacuum
vacuum 是一个超快速的 OpenAPI、AsyncAPI、Arazzo 和 JSON Schema 检查与质量校验工具,灵感来自 Spectral,号…colordiff
colordiff 是一个给命令行 diff 输出加上颜色的小工具。平时用 diff 比较两个文件或目录时,结果全是黑白文字,改动多了看着费劲;colord…openapi-generator
所属分类:命令行工具