如何为TypeScript中从对象生成的类型设置属性默认值？

问题原因 #

你遇到的类型约束不生效的问题，本质是JSON.parse()的返回值类型为any，TypeScript 会跳过对any类型的所有静态检查，所以即使你把缺少age属性的对象塞到Person[]类型的数组里，编译阶段也不会报错。而JavaScript本身是动态类型语言，运行时不会限制对象的属性数量，所以代码可以正常运行，只是实际数据不符合你预期的类型约束。

推荐解决方案 #

方案1：预定义默认值模板+对象合并（最简洁常用） #

提前定义好全量的默认值对象，将JSON解析结果和默认值对象合并，存在的属性会覆盖默认值，缺失的属性会自动用默认值填充，完全不需要硬编码单个属性的判断逻辑。
代码示例：

interface Person {
  name: string;
  age: number;
}

// 预定义Person类型的全量默认值，后续新增属性只要修改这里即可
const DEFAULT_PERSON: Readonly<Person> = {
  name: "未知用户",
  age: 65
};

const tasks: Person[] = [];
// 合并默认值和解析结果
const parsedData = JSON.parse('{"name": "Johannes"}');
const validPerson: Person = {...DEFAULT_PERSON, ...parsedData};
tasks.push(validPerson);

console.log(tasks); // 输出 [{name: "Johannes", age: 65}]

方案2：封装通用默认值填充函数 #

如果有多种类型的对象需要处理，可以封装一个通用工具函数复用逻辑：

function fillObjectDefaults<T extends object>(rawData: Partial<T>, defaultTemplate: T): T {
  return {...defaultTemplate, ...rawData};
}

// 调用示例
const validPerson = fillObjectDefaults<Person>(JSON.parse('{"name": "Johannes"}'), DEFAULT_PERSON);

注意事项 #

如果你的对象存在深层嵌套属性，上述的浅合并逻辑无法处理深层的缺失属性，需要自己实现递归深合并逻辑，或者针对嵌套层级单独定义子属性的默认值再合并。

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