# 使用 Homebrew 安装 oj

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

## 安装

```sh
sudo av install brew:oj
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install oj
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:oj
- **软件包管理器:** Homebrew
- **版本:** 1.28.3
- **来源摘要:** JSON parser and visualization tool
- **主页:** <https://github.com/ohler55/ojg>
- **仓库:** <https://github.com/ohler55/ojg>
- **最后更新:** 2026-08-01T02:59:07Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- oj (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

The Homebrew `oj` package installs the `oj` command from OjG, short for Optimized JSON for Go. OjG is a Go JSON toolkit with a fast parser, validator, writer, JSONPath implementation, generic JSON data model, SEN parser, and command-line JSON filtering/visualization tool.

### 项目历史

OjG was created by Peter Ohler, author of the older Ruby `oj` gem and C `ojc` parser. The repository was created on 2020-04-12. Its design document says the project began from the idea of building a fast JSON parser, generic data model, and full JSONPath implementation for Go, informed by Ohler's earlier JSON parser work.

The project architecture split functionality into packages such as `oj` for parsing, `jp` for JSONPath, `gen` for generic JSON node types, `alt`, `asm`, `sen`, and later `discover`. The `oj` command wraps those libraries for shell use: filtering and extracting with JSONPath, sorting, reformatting, discovering JSON in documents, and colorizing output.

The changelog shows steady evolution after the early releases. Version 1.10.0 in 2021 added a tokenizing callback parser; later releases added path matching, match handlers, script function registration, JSON discovery, and compatibility fixes while keeping semantic versioning.

### 采用历史

OjG is niche but visible in Go JSON-performance circles. The GitHub API reported 950 stars and 53 forks, while Homebrew's 2026-07-01 formula API reported 194 installs over 365 days for the CLI package. Its appeal is strongest where developers want JSONPath over arbitrary JSON-like data or a command-line JSON filter with Go-native implementation details.

The README positions OjG against Go's standard `encoding/json` package through parser, reader, validator, and writer benchmarks, with benchmark links and a separate comparison repository. That performance framing is the main adoption hook.

### 使用方式

Go developers import packages such as `github.com/ohler55/ojg/oj` for parsing and validation, `jp` for JSONPath expressions, and `gen` for type-safe generic data. CLI users install `github.com/ohler55/ojg/cmd/oj` or `brew install oj` to query and format JSON from files and streams.

The parser can process a single JSON document or multiple JSON elements, and options allow comments in JSON. The command-line tool uses JSONPath expressions for filtering, extraction, sorting, reformatting, discovery, and colorized output.

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

The package is a good example of a name collision resolved by package-manager context: Homebrew's `oj` is not the older Ruby gem, but the Go command from OjG. Its upstream project still deliberately links the Go implementation to Ohler's Ruby `Oj` and C `OjC` lineage.

For maintainers, `oj` is a compact Go CLI package with no runtime dependencies in Homebrew, but it carries a rich upstream library surface. The formula's distinction between the CLI name `oj` and upstream module `ojg` is the kind of metadata wrinkle package nerds notice.

### 时间线

- 2020-04-12: the `ohler55/ojg` repository was created.
- 2021-04-22: version 1.10.0 added the tokenizing callback parser.
- 2023-10-03: version 1.19.4 updated the command version and referenced the Homebrew formula.
- 2025-11-11: version 1.27.0 added the `discover` package and discovery option to the `oj` application.
- 2026-03-16: version 1.28.1 removed an accidental Go 1.22 dependency in `alt.Checksum()`.
- 2026-07-01: Homebrew's formula API reported stable version 1.28.1 for `oj`.

### Related projects

- OjG is related to Ohler's Ruby `Oj`, C `OjC`, Ruby XML parser `Ox`, and web-server projects such as Agoo. It is also related to the IETF JSONPath work and to Go JSON parser comparison projects.

### 来源

- <https://api.github.com/repos/ohler55/ojg>
- <https://formulae.brew.sh/api/formula/oj.json>
- <https://github.com/ohler55/ojg>
- <https://pkg.go.dev/github.com/ohler55/ojg>
- <https://pkg.go.dev/github.com/ohler55/ojg/oj>
- <https://raw.githubusercontent.com/ohler55/ojg/develop/CHANGELOG.md>
- <https://raw.githubusercontent.com/ohler55/ojg/develop/README.md>
- <https://raw.githubusercontent.com/ohler55/ojg/develop/design.md>


## 安全说明

narrow executable package without higher-risk signals.

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


## Combined YAML source

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


## 来源

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