# 使用 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
- **软件包管理器页面:** <https://formulae.brew.sh/formula/oasdiff>
- **版本:** 1.27.0
- **来源摘要:** OpenAPI Diff and Breaking Changes
- **主页:** <https://www.oasdiff.com/>
- **仓库:** <https://github.com/oasdiff/oasdiff>
- **上游文档:** <https://www.oasdiff.com/>
- **许可证:** Apache-2.0
- **源码归档:** <https://github.com/oasdiff/oasdiff/archive/refs/tags/v1.27.0.tar.gz>
- **最后更新:** 2026-07-30T21:08:37Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- oasdiff (cli)
- oasdiff (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 1.27.0
- 管理器更新时间: 2026-07-30
- 本地数据: OK
- 上游仓库: https://github.com/oasdiff/oasdiff
- 检测到的最新版本: v1.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。软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。


## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** oasdiff
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

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

- 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


## 相关链接

- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/zh-hans/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/zh-hans/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [fern-api](https://pkg.so/zh-hans/brew/fern-api/) - Shares pkgdb curated category or tags: api, cli, developer-tools, openapi.
- [redocly-cli](https://pkg.so/zh-hans/brew/redocly-cli/) - Shares pkgdb curated category or tags: api, cli, developer-tools, openapi.
- [asyncapi](https://pkg.so/zh-hans/brew/asyncapi/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [atac](https://pkg.so/zh-hans/brew/atac/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [kiota](https://pkg.so/zh-hans/brew/kiota/) - Shares pkgdb curated category or tags: api, cli, developer-tools, openapi.
- [prism-cli](https://pkg.so/zh-hans/brew/prism-cli/) - Shares pkgdb curated category or tags: api, cli, developer-tools, openapi.
- [apibuilder-cli](https://pkg.so/zh-hans/brew/apibuilder-cli/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [curlie](https://pkg.so/zh-hans/brew/curlie/) - Shares pkgdb curated category or tags: api, cli, developer-tools.
- [openapi-diff](https://pkg.so/zh-hans/brew/openapi-diff/) - Local package facts share a topical domain. Shared terms: api, breaking, breaking-changes, changes, cli.
- [cargo-public-api](https://pkg.so/zh-hans/brew/cargo-public-api/) - Local package facts share a topical domain. Shared terms: api, breaking, breaking-changes, changes, cli.

## 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
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
