TypeScript中是否有更优的类型属性映射转换方法？

问题背景 #

我们从数据库获取如下类型的对象：

type SomeEntity = {
    a: string,
    b: string,
    c: {d:string, e:string}[]
}

需要将其转换为如下类型：

type Converted = {
    heading:string,
    copy: string,
    links: {label:string, url:string}[]
}

当前通过编写转换函数实现映射，代码如下：

function convert(data:SomeEntity)
{
    return {
        heading: data.a,
        copy: data.b,
        links: {label:data.c.d, url:label.data.e}[]
    } as Converted
}

这种方式十分繁琐。了解过map函数，但仍需逐一赋值；也了解过Mapped types，不过它似乎更偏向类型扩展而非完整转换。请问是否存在比当前方法更优的类型映射转换方式？

更优实现方案 #

1. 修正基础数组映射逻辑 #

你当前转换函数里links的写法存在语法错误，正确的数组映射应该用Array.map()遍历data.c，而且只要类型匹配，TypeScript会自动推导返回类型，无需手动断言：

function convert(data: SomeEntity): Converted {
  return {
    heading: data.a,
    copy: data.b,
    links: data.c.map(item => ({ label: item.d, url: item.e }))
  };
}

这种写法在字段较少的场景下足够简洁，且类型完全安全。

2. 用映射配置实现批量转换 #

如果后续有大量字段需要映射，或者字段映射规则可能频繁变动，可以定义映射规则配置，通过通用函数自动完成转换，减少重复代码：

// 定义字段映射规则：目标字段 -> 源字段
const entityToConvertedMap = {
  heading: 'a',
  copy: 'b'
} as const;

// 通用转换函数，支持自定义复杂字段转换
function convertEntity<T extends Record<string, any>, U extends Record<string, keyof T>>(
  data: T,
  fieldMap: U,
  customTransforms?: Partial<Record<keyof U | 'links', (data: T) => any>>
): { [K in keyof U]: T[U[K]] } & Omit<Converted, keyof U> {
  // 处理基础字段映射
  const baseFields = Object.fromEntries(
    Object.entries(fieldMap).map(([targetKey, sourceKey]) => [targetKey, data[sourceKey]])
  ) as { [K in keyof U]: T[U[K]] };
  
  // 合并自定义转换字段
  return {
    ...baseFields,
    links: customTransforms?.links?.(data) || data.c.map(item => ({ label: item.d, url: item.e }))
  };
}

// 使用示例
const someEntityData: SomeEntity = { a: '标题', b: '描述', c: [{ d: '链接1', e: 'url1' }] };
const converted = convertEntity(someEntityData, entityToConvertedMap);

这种方案的优势：

• 新增/修改字段只需调整映射配置，无需改动转换逻辑
• 复杂字段可通过customTransforms传入自定义处理函数
• 完全保留TypeScript的类型推导能力，避免手动断言带来的风险

3. 专业转换类库辅助（可选） #

如果项目中有大量复杂类型转换场景，比如嵌套结构、类型校验等，可以使用class-transformer这类专门的转换类库：

import { Transform, plainToInstance } from 'class-transformer';

class ConvertedDto {
  @Transform(({ obj }) => obj.a)
  heading: string;

  @Transform(({ obj }) => obj.b)
  copy: string;

  @Transform(({ obj }) => obj.c.map(item => ({ label: item.d, url: item.e })))
  links: { label: string; url: string }[];
}

// 使用方式
const converted = plainToInstance(ConvertedDto, someEntityData);

类库支持更多高级特性，比如反向转换、嵌套对象转换、装饰器扩展等，适合大型项目批量处理类型转换需求。

总结 #

• 简单场景：直接用修正后的基础转换函数，代码简洁且类型安全
• 多字段/频繁变动场景：用映射配置+通用函数，减少重复代码维护成本
• 大型复杂项目：引入专业转换类库提升开发效率

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