如何将TypeScript嵌套可选参数平级映射至指定接口对象？

先明确你的接口结构示例（方便理解场景）：

// 表单参数接口（含嵌套可选参数）
interface AdmissionFormParams {
  employeeParams: {
    id: string;
    name: string;
    optionalParams?: {
      age?: number;
      department?: string;
      phone?: string;
    };
  };
  // 其他表单字段...
}

// 断言用的平级员工数据接口
interface EmployeeDataParams {
  id: string;
  name: string;
  age?: number;
  department?: string;
  phone?: string;
}

方案1：直接使用对象展开运算符 #

这是最简洁的写法，利用TypeScript的对象展开特性，结合空值兜底处理可选参数可能为undefined的情况：

const admissionData: AdmissionFormParams = {
  employeeParams: {
    id: 'EMP001',
    name: '张三',
    optionalParams: { age: 30, department: '技术部' }
  }
};

// 合并生成符合EmployeeDataParams的对象
const employeeData: EmployeeDataParams = {
  ...admissionData.employeeParams,
  ...admissionData.employeeParams.optionalParams ?? {}
};

这里用?? {}是为了在optionalParams为undefined或null时，展开一个空对象避免报错，比|| {}更严谨（不会误判0、''等 falsy 值）。

方案2：封装复用工具函数 #

如果多个测试场景需要转换，封装成工具函数可以减少重复代码：

function mapToEmployeeData(
  employeeParams: AdmissionFormParams['employeeParams']
): EmployeeDataParams {
  return {
    ...employeeParams,
    ...employeeParams.optionalParams ?? {}
  };
}

// 调用示例
const employeeData = mapToEmployeeData(admissionData.employeeParams);

这种方式可以统一维护转换逻辑，后续如果接口结构调整，只需要修改这一个函数。

注意事项 #

• 如果optionalParams中存在和employeeParams平级的同名属性，展开后嵌套参数会覆盖平级参数，确保接口设计中不存在这种冲突，或者根据业务需求调整合并顺序。
• TypeScript会自动校验合并后的对象类型是否符合EmployeeDataParams，只要接口定义正确，无需额外类型断言。

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