如何将TypeScript类型T中所有对象类型的属性设为可选？

我们可以通过自定义TypeScript工具类型实现这个需求——遍历目标类型的所有属性，将类型为非null的object的属性标记为可选，其余属性保持原有的必选状态。

实现步骤 #

1. 定义辅助类型判断是否为非null的object

TypeScript中null的类型也属于object范畴，我们需要排除这种情况：

type IsObject<T> = T extends object ? T extends null ? false : true : false;

2. 实现核心工具类型

通过映射类型筛选并拆分属性，再用交叉类型合并结果：

type ObjectPropertiesOptional<T> = {
  // 筛选出类型为object的属性，标记为可选
  [K in keyof T as IsObject<T[K]> extends true ? K : never]?: T[K];
} & {
  // 筛选出非object类型的属性，保持必选
  [K in keyof T as IsObject<T[K]> extends false ? K : never]: T[K];
};

使用示例 #

原类型定义

interface MyObject {
  name: string;
  age: number;
  favorites: {
    color: string;
  };
}

应用工具类型

type MyNewObject = ObjectPropertiesOptional<MyObject>;

最终等价类型

interface MyNewObject {
  name: string;
  age: number;
  favorites?: {
    color: string;
  };
}

扩展：递归处理嵌套object属性 #

如果需要将嵌套层级里的所有object类型属性也设为可选，可以使用递归版本的工具类型：

type IsObject<T> = T extends object ? T extends null ? false : true : false;

type ObjectPropertiesOptionalRecursive<T> = {
  [K in keyof T as IsObject<T[K]> extends true ? K : never]?: ObjectPropertiesOptionalRecursive<T[K]>;
} & {
  [K in keyof T as IsObject<T[K]> extends false ? K : never]: T[K];
};

这个版本会自动处理所有层级的object属性，适用于结构更复杂的类型。

内容的提问来源于stack exchange，提问作者Freddx L.