npm 包 ts-jsonschema-gen 使用教程
前言
在前端开发过程中，我们难免会遇到需要进行数据模型定义的需求，我们需要定义数据的类型、属性、枚举等等。目前比较流行的方式是使用 JSON Schema 来定义数据模型，然后使用一些工具生成对应的代码。而本文介绍的工具就是其中之一，它叫做 ts-jsonschema-gen 。
什么是 ts-jsonschema-gen ？
ts-jsonschema-gen 是一个 npm 包，用于根据 JSON Schema 文件自动生成 TypeScript 的模型定义。
使用 ts-jsonschema-gen 可以极大地提高编写 TypeScript 模型定义的效率，减少手写模型定义所带来的出错风险。
安装 ts-jsonschema-gen
要安装 ts-jsonschema-gen，只需要在命令行中输入以下代码：
npm install --save-dev ts-jsonschema-gen
使用 ts-jsonschema-gen
使用 ts-jsonschema-gen 来生成 TypeScript 模型定义非常简单，只需要两个步骤：
- 编写 JSON Schema 文件
- 使用 ts-jsonschema-gen 生成 TypeScript 模型定义文件
编写 JSON Schema 文件
下面是一个使用 JSON Schema 定义数据模型的示例：
-- -------------------- ---- -------
-
---------- ---------------------------------
-------- ---------
------- ---------
------------- -
------- -
------- --------
--
------ -
------- ---------
---------- --
---------- ---
--
--------- -
------- ---------
------- -------- ---------
-
--
----------- -------- ------
-在这个 JSON Schema 中，我们定义了一个名为 Person 的对象，它有三个属性：name、age 和 gender。其中，name 是一个字符串类型的必选项，age 是一个数值类型的必选项，且取值范围在 0 - 200 之间，gender 是一个枚举类型的可选项，其取值为 male 或者 female。
我们将这个 JSON Schema 文件保存为 person.schema.json 。
使用 ts-jsonschema-gen 生成 TypeScript 模型定义文件
下面是使用 ts-jsonschema-gen 生成 TypeScript 模型定义文件的示例代码：
ts-jsonschema-gen -i person.schema.json -o person.ts
执行这段代码后，ts-jsonschema-gen 就会读取 person.schema.json 文件，并根据其内容生成一个名为 person.ts 的 TypeScript 模型定义文件。
示例
假设我们有一个数据接口返回的 JSON 数据如下：
{
"name": "curry",
"age": 33,
"gender": "male"
}我们可以使用 ts-jsonschema-gen 生成对应的 TypeScript 模型定义，如下所示：
export interface Person {
name: string;
age: number;
gender?: 'male' | 'female';
}然后我们就可以在代码中使用 Person 接口来对数据进行类型安全的处理，例如：
import { Person } from './person';
const person: Person = {
name: 'curry',
age: 33,
gender: 'male'
};这里我们在声明 person 变量时使用了 Person 接口，这样就能够保证 person 的属性和类型与 Person 接口中的定义一致。
总结
通过本文的介绍，我们学习了如何使用 ts-jsonschema-gen 这个 npm 包来自动生成 TypeScript 的模型定义。使用这个工具可以减少手写模型定义所带来的出错风险，提高编写 TypeScript 模型定义的效率。在前后端分离开发的时候，使用 ts-jsonschema-gen 可以让前端与后端的开发更加高效和协调。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60065f73238a385564ab6844