# 使用 Homebrew, MacPorts 安装 oasdiff

查看 oasdiff 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:oasdiff
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install oasdiff
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install oasdiff
```

  证据: MacPorts ports tree: devel/oasdiff/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:oasdiff
- **软件包管理器:** Homebrew
- **版本:** 1.27.0
- **来源摘要:** OpenAPI Diff and Breaking Changes
- **主页:** <https://www.oasdiff.com/>
- **仓库:** <https://github.com/oasdiff/oasdiff>
- **最后更新:** 2026-07-30T21:08:37Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- oasdiff (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.27.0
## 项目历史与用法

oasdiff is a Go command-line and library toolchain for comparing OpenAPI specifications, generating diffs and changelogs, and detecting breaking API changes. It is aimed at API teams that want contract changes to fail CI or receive review before release.

### 项目历史

The GitHub repository was created on February 10, 2021. The project grew from a CLI that compares OpenAPI specs into a broader workflow with GitHub Actions, hosted side-by-side reviews, language-localized change messages, and support for OpenAPI 3.0 and 3.1.

### 采用历史

oasdiff's adoption path is tied to CI and pull-request review rather than a runtime ecosystem. The official GitHub Action compares a pull request's OpenAPI document with the base branch, emits GitHub annotations, and can fail builds when breaking changes are detected.

### 使用方式

Developers run commands such as oasdiff diff, oasdiff breaking, and oasdiff changelog against two OpenAPI files or URLs. The tool supports machine-readable JSON/YAML output, human-readable text or Markdown, and HTML reports, making it suitable for both automated gates and reviewer-facing summaries.

### 为什么软件包爱好者会关心

oasdiff is significant because it packages API compatibility policy as a normal developer tool: installable by Homebrew, Go, curl, Docker, and GitHub Actions, and usable in the same CI loops that already protect tests and linting.

### 时间线

- 2021-02-10: oasdiff/oasdiff repository was created.
- 2026-06-28: GitHub release v1.21.0 was published.
- The documentation describes Homebrew, curl, Docker, Go install, and prebuilt binary installation routes.

### Related projects

- The oasdiff-action repository packages the CLI for GitHub Actions. The project is also tied to the OpenAPI Specification ecosystem and to the oasdiff.com review workflow for side-by-side API contract review.

### 来源

- <https://api.github.com/repos/oasdiff/oasdiff>
- <https://formulae.brew.sh/formula/oasdiff>
- <https://github.com/oasdiff/oasdiff>
- <https://github.com/oasdiff/oasdiff-action>
- <https://github.com/oasdiff/oasdiff/blob/main/docs/BREAKING-CHANGES.md>
- <https://github.com/oasdiff/oasdiff/releases>
- <https://www.oasdiff.com/docs/getting-started>
- <https://www.oasdiff.com/docs/github-action>


## 安全说明

没有找到 oasdiff 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。


## 其他软件包管理器记录

- MacPorts - oasdiff: normalized package name match | MacPorts ports tree: devel/oasdiff/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/oasdiff.yml](https://github.com/mxcl/pkgdb/blob/main/combined/oasdiff.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph