如何根据传入的expand数组动态调整TypeScript接口字段类型？

直接用TypeScript的泛型和类型映射就能解决这个问题，不用手动维护几十种字段组合，完美适配你6个可扩展字段的场景。

实现方案 #

1. 梳理基础类型与扩展映射 #

先把基础类型、可扩展字段的完整类型做结构化映射，后续替换类型更高效：

// 可扩展字段对应的完整对象类型
interface MyObject {
  name: string;
  email: string;
}

interface MyAddress {
  street: string;
  state: string;
  country: string;
}

// 基础Person类型：所有可扩展字段默认是string（ID形式）
type BasePerson = {
  id: string;
  personalDetails: string;
  address: string;
  // 把其他4个可扩展字段也加到这里，默认类型均为string
};

// 定义「可扩展字段名」到「对应完整类型」的映射表
type ExpandableTypeMap = {
  personalDetails: MyObject;
  address: MyAddress;
  // 新增可扩展字段时，直接在这里补充对应的类型映射即可
};

// 自动推导可扩展字段的联合类型
type ExpandableFields = keyof ExpandableTypeMap;

2. 编写动态生成类型的泛型 #

通过泛型接收expand字段列表，自动替换对应字段的类型：

// 动态生成扩展后的Person类型
type ExpandedPerson<T extends ExpandableFields[] = []> = 
  // 移除基础类型中需要扩展的字段
  Omit<BasePerson, T[number]> & 
  // 从映射表中选取扩展后的字段类型
  Pick<ExpandableTypeMap, T[number]>;

3. 给API方法添加泛型关联 #

让get方法的请求参数和返回类型绑定，TypeScript会自动完成类型推断：

// 模拟你的API库结构
const library = {
  person: {
    get<T extends ExpandableFields[] = []>(
      params?: { expand?: T }
    ): ExpandedPerson<T> {
      // 这里放置实际API请求逻辑，返回值用类型断言兜底
      return {} as ExpandedPerson<T>;
    }
  }
};

实际调用效果 #

不管传多少个扩展字段，类型都会自动匹配：

• 不传expand：返回基础类型，可扩展字段均为string

const person = library.person.get();
person.personalDetails; // 类型为string，无法访问name属性

• 传单个扩展字段：对应字段转为完整对象类型

const personWithDetails = library.person.get({ expand: ['personalDetails'] });
personWithDetails.personalDetails.name; // 类型正确，无报错

• 传多个扩展字段：所有指定字段都转为对应对象类型

const fullPerson = library.person.get({ expand: ['personalDetails', 'address'] });
fullPerson.address.street; // 类型正确，无报错

方案优势 #

• 新增可扩展字段仅需修改BasePerson和ExpandableTypeMap，无需维护大量类型组合
• 自动覆盖6个字段对应的64种组合情况，无需手动编写
• 用户调用时获得精准类型提示，提前规避类型错误

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