# @axway/swagger-tools 中文文档

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

版本：1\.1\.0
npm 元数据更新时间：2025-09-15T11:38:52.426Z
中文译文更新时间：2026-11-07T21:48:45.368Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：184 kB，15 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>= 10\.16\.0
- 运行依赖：13 个
- 首次发布：2020-10-27T17:49:40.391Z
- 最新版本发布：2025-09-15T11:38:11.530Z
- 近 30 天下载量：2394（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 0 个）

## 中文简介

使用并集成于斯瓦格2.0的各种工具.

## 安装

```sh
npm install @axway/swagger-tools
```

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

## README

该项目为与斯瓦格的融合和互动提供了各种工具. 这个项目尚处于初期阶段,但 应充分测试和重新使用储存库内的东西。 请访问 [问题跟踪器](https://github.com/apigee/swagger-tools/issues) 改为 看看我们意识到什么问题,以及我们正在研究什么特征/加强。 要不然,请随意审查一下 [发布注释](https://github.com/apigee-127/swagger-tools/blob/master/RELEASE_NOTES.md) 以了解什么是新的和改进.

## 项目徽章

[![Join the chat at https://gitter.im/apigee-127/swagger-tools](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/apigee-127/swagger-tools?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

-   构建状态 : [![Build Status](https://travis-ci.org/apigee-127/swagger-tools.svg)](https://travis-ci.org/apigee-127/swagger-tools)
-   依赖性 : [![Dependencies](https://david-dm.org/apigee-127/swagger-tools.svg)](https://david-dm.org/apigee-127/swagger-tools)
-   开发者依赖性 : [![Dev Dependencies](https://david-dm.org/apigee-127/swagger-tools/dev-status.svg)](https://david-dm.org/apigee-127/swagger-tools#info=devDependencies&view=table)
-   下载数 : [![NPM Downloads Per Month](http://img.shields.io/npm/dm/swagger-tools.svg?style=flat)](https://www.npmjs.org/package/swagger-tools)
-   许可证 : [![License](http://img.shields.io/npm/l/swagger-tools.svg?style=flat)](https://github.com/apigee-127/swagger-tools/blob/master/LICENSE)
-   鲍尔版本 [![NPM Version](https://img.shields.io/bower/v/swagger-tools.svg?style=flat)](http://bower.io/search/?q=swagger-tools)
-   国家预防机制版本: [![NPM Version](http://img.shields.io/npm/v/swagger-tools.svg?style=flat)](https://www.npmjs.org/package/swagger-tools)

## 支持的 Swagger 版本

-   [1.2 国家](https://github.com/swagger-api/swagger-spec/blob/master/versions/1.2.md)
-   [2.0 数据](https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md)

## 特征

-   简单 CLI
    -   验证 Swagger 文档
    -   将 Swagger 1.2 文档转换为 Swagger 2.0
-   Schema验证:对于Swagger规格支持的文件,确保它们通过结构验证 基于 [杰森·斯克马](http://json-schema.org/) 与该规格版本有关 _(浏览器和节点)_
-   语义验证: 在文件结构之上及之外验证 Swagger 文件 _(浏览器和节点)_
-   连接中间软件,将相关的 Swagger 信息添加到您的请求中 _(仅节点)_
-   根据 Swagger 文档连接安全处理器的中端软件 _(仅节点)_
-   根据 Swagger 文档连接线程请求处理器的中间软件 _(仅节点)_
-   连接服务您 Swagger 文档的中间软件 [Swagger 用户界面](https://github.com/swagger-api/swagger-ui) _(仅节点)_
-   连接用于使用 Swagger 资源文档进行预路由验证的中间软件 _(仅节点)_
    -   根据操作的 `consumes/produces` 数值
    -   验证请求参数类型
    -   验证请求参数值
    -   验证响应值

## 安装

Swagger Tools同时可供Node.js和浏览器使用. 每种环境的安装说明如下.

### 浏览器

浏览器应用程序的安装可以通过 [鲍尔](http://bower.io/) 或下载独立的二进制.

#### 使用鲍尔

```
bower install swagger-tools --save
```

#### 独立的二进制

独立二进制有两种口味:

-   [摇摆-工具-独立.js](https://raw.github.com/apigee-127/swagger-tools/master/browser/swagger-tools-standalone.js)数字 : _2 280克b (中文(简体) )_,完整来源 _(包括所有依附关系)_ 和源地图
-   [斯瓦格-工具-独立-min.js](https://raw.github.com/apigee-127/swagger-tools/master/browser/swagger-tools-standalone-min.js)数字 : _316kb (韩语)_, 修改后, 压缩 没有源图

### 节点.js

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

```
npm install swagger-tools --save
```

如果你想用这个 `swagger-tools` 用于验证 Swagger 文档的可执行文件, 您可以安装 swagger 工具 全球使用:

```
npm install -g swagger-tools
```

## 文档

{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}那就直接去项目吧 [文档](https://github.com/apigee-127/swagger-tools/blob/master/docs/README.md) 或者直接跳转到 页:1 [快速启动](https://github.com/apigee-127/swagger-tools/blob/master/docs/QuickStart.md)。 。 。 .

## 捐款

这个项目使用 [古尔普](http://gulpjs.com/) 用来建造这样的 `npm install -g gulp` 一旦你复制了这个项目。 运行 `gulp` 输入 project root 将进行源代码检查并运行单位测试.

## 常见问题

### @axway/swagger-tools 是什么？

使用并集成于斯瓦格2\.0的各种工具\.

### 如何安装 @axway/swagger-tools？

在项目目录运行 npm install @axway/swagger-tools，或使用 pnpm add / yarn add / bun add。

### @axway/swagger-tools 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/axway\_\_swagger-tools 是否存在。

### @axway/swagger-tools 支持 ESM 还是 CommonJS？

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

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

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

### @axway/swagger-tools 可以商用吗？

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

### @axway/swagger-tools 的下载量有多少？

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

### @axway/swagger-tools 还在维护吗？

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