如何在TypeScript中构建灵活字典结构及外部数据映射方案

针对多数据源字段命名不一致、需频繁适配变更的场景，最实用的方案是映射配置与通用转换函数分离的模式——把字段映射规则抽离成独立配置，转换逻辑复用通用函数，这样字段变更只需修改配置，无需改动核心转换代码。

实现步骤 #

1. 定义映射配置类型 #

先声明支持两种映射方式的配置类型：直接字段名映射，或自定义转换函数（应对复杂场景）：

// 内部统一数据结构
type Internal = {
  size: number,
  height: number
};

// 外部数据源示例结构
type External1 = { size1: number; height1: number };
type External2 = { size2: number; height2: number };

// 映射配置类型：键为内部字段名，值为外部字段名或转换函数
type FieldMapper<TExternal> = {
  [K in keyof Internal]: keyof TExternal | ((source: TExternal) => Internal[K]);
};

2. 编写各数据源的映射配置 #

针对每个外部数据源，编写对应的字段映射规则，规则集中管理，变更时直接修改此处：

// External1的映射配置
const external1Mapper: FieldMapper<External1> = {
  size: 'size1',
  height: 'height1'
};

// External2的映射配置
const external2Mapper: FieldMapper<External2> = {
  size: 'size2',
  height: 'height2'
};

3. 实现通用转换函数 #

编写一个通用函数，根据传入的映射配置，自动将外部数据转换为内部结构：

function convertToInternal<TExternal>(
  source: TExternal,
  mapper: FieldMapper<TExternal>
): Internal {
  const result: Partial<Internal> = {};

  // 遍历所有内部字段，按映射规则取值
  for (const internalKey of Object.keys(mapper) as Array<keyof Internal>) {
    const mapperValue = mapper[internalKey];
    if (typeof mapperValue === 'function') {
      // 执行自定义转换逻辑
      result[internalKey] = mapperValue(source);
    } else {
      // 直接映射字段值
      result[internalKey] = source[mapperValue];
    }
  }

  // 断言为完整Internal类型（需确保映射配置覆盖所有内部字段）
  return result as Internal;
}

4. 使用示例 #

调用通用函数，传入外部数据和对应映射配置即可完成转换：

// 转换External1数据
const external1Data: External1 = { size1: 10, height1: 20 };
const internalData1 = convertToInternal(external1Data, external1Mapper);
console.log(internalData1); // { size: 10, height: 20 }

// 转换External2数据
const external2Data: External2 = { size2: 15, height2: 25 };
const internalData2 = convertToInternal(external2Data, external2Mapper);
console.log(internalData2); // { size: 15, height: 25 }

5. 应对复杂转换场景 #

如果外部数据需要类型转换、计算等复杂处理，直接在映射配置中使用函数即可：

// 示例：外部返回字符串类型的尺寸，高度单位为厘米
type External3 = { sizeStr: string; heightCm: number };

const external3Mapper: FieldMapper<External3> = {
  size: (source) => parseInt(source.sizeStr, 10),
  height: (source) => source.heightCm / 100 // 转换为米
};

const external3Data: External3 = { sizeStr: '20', heightCm: 180 };
const internalData3 = convertToInternal(external3Data, external3Mapper);
console.log(internalData3); // { size: 20, height: 1.8 }

方案优势 #

• 低耦合：映射规则与转换逻辑分离，字段变更仅需修改配置，无需改动核心代码
• 高可维护：所有映射规则集中管理，清晰直观，便于排查问题
• 强扩展性：支持自定义转换函数，轻松应对各种复杂数据处理场景

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