# 使用 Homebrew, pacman 安装 openapi-diff

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

## 安装

```sh
sudo av install brew:openapi-diff
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install openapi-diff
```

  证据: local Homebrew formula metadata

### Linux

- pacman (92%):

```sh
sudo pacman -S openapi-diff
```

  证据: Arch Linux sync databases: openapi-diff from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## 软件包事实

- **软件包键:** brew:openapi-diff
- **软件包管理器:** Homebrew
- **版本:** 2.1.7
- **来源摘要:** Utility for comparing two OpenAPI specifications
- **主页:** <https://github.com/OpenAPITools/openapi-diff>
- **仓库:** <https://github.com/OpenAPITools/openapi-diff>
- **最后更新:** 2026-06-22T14:05:41-07:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- openapi-diff (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

openapi-diff is an OpenAPITools utility for comparing two OpenAPI 3.x specifications and rendering the differences as text, HTML, Markdown, AsciiDoc, or JSON. Its main job is to tell teams whether an API description changed and whether those changes are compatible or incompatible.

### 项目历史

The repository was created on December 12, 2017 and later moved under the OpenAPITools umbrella. A project discussion for version 2.0.0 on December 5, 2021 described that release as the first stable OpenAPI-Diff release under the OpenAPI Tools organization.

### 采用历史

The project is distributed as Java artifacts on Maven Central, a Docker image under `openapitools/openapi-diff`, and a Homebrew formula. That packaging mix reflects its use both as a library/plugin in Java builds and as a standalone CLI in local or CI workflows.

### 使用方式

Developers invoke `openapi-diff <old> <new>` against local files or HTTP URLs, then choose renderers or state-only output. CI users can turn compatibility checks into gates with options such as `--fail-on-incompatible` or `--fail-on-changed`.

Java projects can add the Maven plugin to compare a reference specification against a generated build artifact during tests. The README also documents direct invocation through the core API for custom comparison tooling.

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

openapi-diff is package-nerd-interesting because it treats API descriptions as build artifacts with semantic compatibility. It turns OpenAPI files from passive documentation into something package managers, CI systems, and release processes can enforce.

### 时间线

- December 12, 2017: the GitHub repository was created. December 5, 2021: the 2.0.0 discussion announced the first stable OpenAPI-Diff release under OpenAPI Tools. January 26, 2026: GitHub releases list version 2.1.7.

### Related projects

- openapi-diff lives in the OpenAPITools ecosystem alongside OpenAPI Generator and shares the same broader OpenAPI/Swagger tooling context.

### 来源

- <https://api.github.com/repos/OpenAPITools/openapi-diff>
- <https://formulae.brew.sh/formula/openapi-diff>
- <https://github.com/OpenAPITools/openapi-diff>
- <https://github.com/OpenAPITools/openapi-diff/discussions/297>
- <https://hub.docker.com/r/openapitools/openapi-diff>
- <https://search.maven.org/artifact/org.openapitools.openapidiff/openapi-diff-core>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

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

- pacman - openapi-diff - 2.1.7-1: normalized package name match | Arch Linux sync databases: openapi-diff from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Utility for comparing two OpenAPI specifications | https://github.com/OpenAPITools/openapi-diff


## Combined YAML source

View the package source record on GitHub. [combined/openapi-diff.yml](https://github.com/mxcl/pkgdb/blob/main/combined/openapi-diff.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