JSON转TypeScript模型示例及接口/类选型建议（部门数据自动补全）

没问题，我来帮你搞定这个TypeScript模型的事儿！先给你针对法国大区和部门数据的模型示例，再聊聊Interface和Class该怎么选。

TypeScript模型示例 #

首先，根据法国大区（Région）和部门（Département）的典型数据结构，我给你写两种常见场景的模型：

场景1：JSON是嵌套的大区-部门结构 #

如果你的JSON是按大区分组，每个大区下包含多个部门，用下面的类型定义：

// 单个部门的类型描述
interface Department {
  // 部门编号，比如"75"对应巴黎
  code: string;
  // 部门名称，比如"Paris"
  name: string;
}

// 单个大区的类型描述
interface Region {
  // 大区编号，比如"11"对应法兰西岛
  code: string;
  // 大区名称，比如"Île-de-France"
  name: string;
  // 该大区下的所有部门列表
  departments: Department[];
}

// 整个数据集的类型（大区数组）
type FrenchRegionsDataset = Region[];

场景2：JSON是扁平的部门列表 #

如果你的JSON直接是所有部门的列表（不带大区嵌套），可以用简化版的定义：

interface Department {
  code: string;
  name: string;
  // 可选字段：如果部门数据里关联了大区信息，可以加上
  regionCode?: string;
  regionName?: string;
}

// 整个数据集的类型（部门数组）
type FrenchDepartmentsDataset = Department[];

把你的JSON数据导入后，用上面的类型约束变量，编辑器（比如VS Code）就能自动识别结构，提供精准的代码补全了。

Interface还是Class？该怎么选？ #

这完全取决于你的实际需求：

优先选Interface（绝大多数自动补全场景） #

• 完美适配自动补全需求：Interface是TypeScript专门用来描述数据结构的类型工具，编辑器能100%识别它，给你提供字段补全、类型校验，完全满足你想要的部门数据自动补全功能。
• 轻量无负担：Interface只是编译时的类型标记，不会被编译成JavaScript代码，不会增加运行时的性能开销。
• 直接映射JSON：JSON本质就是纯对象，Interface能直接和这种结构匹配，不需要额外的实例化步骤，直接赋值就行：

  import departmentsData from './french-departments.json';
  // 类型约束后，编辑器自动补全 departmentsData 里的字段
  const departments: FrenchDepartmentsDataset = departmentsData;
  

考虑选Class（仅当需要附加方法时） #

如果你的部门数据需要额外的行为逻辑（比如根据编号查找部门、格式化显示名称），那Class会更合适：

class Department {
  code: string;
  name: string;

  constructor(code: string, name: string) {
    this.code = code;
    this.name = name;
  }

  // 自定义方法：返回格式化的部门信息
  getFullLabel(): string {
    return `${this.code} - ${this.name}`;
  }
}

// 把JSON数据转换成Class实例
import rawData from './french-departments.json';
const departments: Department[] = rawData.map(item => new Department(item.code, item.name));

但如果只是单纯的自动补全和数据结构校验，Class就有点画蛇添足了，反而增加了不必要的代码量。

内容的提问来源于stack exchange，提问作者pierre