# @axway/json-refs 中文文档

规范地址：https://npmcn.com/package/%40axway/json-refs/

版本：4\.0\.0
npm 元数据更新时间：2025-07-25T08:30:35.470Z
中文译文更新时间：2026-11-07T21:36:40.439Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40axway/json-refs
原文对照：https://npmcn.com/package/%40axway/json-refs/?lang=original
项目主页：https://github.com/Axway/json-refs
源码仓库：https://github.com/Axway/json-refs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.2 MB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=0\.8
- 运行依赖：8 个
- 首次发布：2021-02-26T11:52:17.601Z
- 最新版本发布：2021-02-26T11:52:17.995Z
- 近 30 天下载量：2404（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

JSON 参考资料的各种公用事业[http://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03 (英语)](http://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03)) (中文(简体) ).

## 安装

```sh
npm install @axway/json-refs
```

也可以使用：`pnpm add @axway/json-refs`、`yarn add @axway/json-refs`、`bun add @axway/json-refs`

## README

# json-refs (英语)

json-refs是一个简单的库,用于与 [JSON 参考文献](http://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03) 财务报告和审定财务报表 [JSON 指针](http://tools.ietf.org/html/rfc6901)虽然这个图书馆的主要目的是提供JSON参考功能, 自JSON以来 参考文献包括: `Object` 结构a `JSON Pointer`这个图书馆也提供一些 jSON 指针的功能.

## 项目徽章

-   构建状态 : [![Build Status](https://travis-ci.org/whitlockjc/json-refs.svg)](https://travis-ci.org/whitlockjc/json-refs)
-   依赖性 : [![Dependencies](https://david-dm.org/whitlockjc/json-refs.svg)](https://david-dm.org/whitlockjc/json-refs)
-   开发者依赖性 : [![Dev Dependencies](https://david-dm.org/whitlockjc/json-refs/dev-status.svg)](https://david-dm.org/whitlockjc/json-refs#info=devDependencies&view=table)
-   下载数 : [![NPM Downloads Per Month](http://img.shields.io/npm/dm/json-refs.svg)](https://www.npmjs.org/package/json-refs)
-   齿轮 : [![Join the chat at https://gitter.im/whitlockjc/json-refs](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/whitlockjc/json-refs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-   许可证 : [![License](http://img.shields.io/npm/l/json-refs.svg)](https://github.com/whitlockjc/json-refs/blob/master/LICENSE)
-   版本 : [![NPM Version](http://img.shields.io/npm/v/json-refs.svg)](https://www.npmjs.org/package/json-refs)

## 文档

该项目的文件可在下列网址查阅: [https://github.com/whitlockjc/json-refs/blob/master/docs/README.md 互联网档案馆的存檔,存档日期2014-12-02](https://github.com/whitlockjc/json-refs/blob/master/docs/README.md)。 。 。 . 具体文件见此:

-   API 文档可见于 [https://github.com/whitlockjc/json-refs/blob/master/docs/API.md 互联网档案馆的存檔,存档日期2014-12-02](https://github.com/whitlockjc/json-refs/blob/master/docs/API.md)
-   CLI 可见于 [https://github.com/whitlockjc/json-refs/blob/master/docs/CLI.md. 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/whitlockjc/json-refs/blob/master/docs/CLI.md)

## 安装

json-refs既可用于Node.js,也可用于浏览器. 每种环境的安装说明如下.

### 浏览器

用于浏览器的 json-refs 二进制在 `dist/` 目录 :

-   [json-refs.js (英语)](https://raw.github.com/whitlockjc/json-refs/master/dist/json-refs.js)数字 : _2 292克b (单位:千美元)_,完整源代码地图
-   [json-refs-min.js (英语)](https://raw.github.com/whitlockjc/json-refs/master/dist/json-refs-min.js)数字 : _148kb (中文(简体) )_、 已修改、 压缩和无源图

当然,这些链接是给主造的,所以觉得可以自由地从您选择的发布中下载. 一旦你来了 下载后,为了使用独立的二进制, 您的 HTML 包含可能像这样:

```html
<!-- ... -->
<script src="json-refs.js"></script>
<!-- ... -->
```

### 节点.js

节点Js应用程序的安装可以通过 [国家预防机制](https://www.npmjs.com/)。 。 。 .

```
npm install json-refs --save
```

如果你计划使用 `json-refs` CLI 可执行文件, 您可以在此全球安装 json- refs :

```
npm install json-refs --global
```

吃完这个,随便跑 `json-refs help` 查看上面链接的 CLI 文档

## 常见问题

### @axway/json-refs 是什么？

JSON 参考资料的各种公用事业http://tools\.ietf\.org/html/draft-pbryan-zyp-json-ref-03 \(英语\)\) \(中文\(简体\) \)\.

### 如何安装 @axway/json-refs？

在项目目录运行 npm install @axway/json-refs，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 json-refs，可以用 npx json-refs 直接运行。

### @axway/json-refs 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @axway/json-refs 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @axway/json-refs 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=0\.8。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @axway/json-refs 可以商用吗？

@axway/json-refs 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @axway/json-refs 的下载量有多少？

根据 npm 官方下载统计，@axway/json-refs 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,404 次，日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @axway/json-refs 还在维护吗？

最新版本 4\.0\.0 发布于 2021/02/26（5 年前）；至今共发布 1 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/02/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。