本文介绍使用 DeepPartial 工具类型，递归地将类及其嵌套属性（包括数组元素）的所有字段设为可选，从而安全、泛型化地支持部分初始化，避免类型错误。

本文介绍使用 deeppartial 工具类型，递归地将类及其嵌套属性（包括数组元素）的所有字段设为可选，从而安全、泛型化地支持部分初始化，避免类型错误。

在 TypeScript 中，当类具有嵌套结构（如数组中包含继承自基类的子类实例）时，仅用 Partial 无法满足深层初始化需求——它只作用于顶层属性，对数组内部元素类型不生效。例如，Baz 类的 bars: Bar[] 属性期望 Bar 实例，但传入 Foo（Bar 的父类）时会报错：Property 'bar' is missing in type 'Foo' but required in type 'Bar'。

根本原因在于：Partial 仅将 bars 字段设为可选，但 bars 的元素类型仍是严格的 Bar，而非 Partial 或更宽松的 Partial & Partial。此时，标准 Partial 失效，需引入递归可选类型。

✅ 推荐方案：DeepPartial 工具类型

DeepPartial 是一个泛型工具类型，它递归遍历所有嵌套层级（对象、数组、联合类型等），将每个属性标记为可选：

type DeepPartial<T> = {
  [K in keyof T]?: DeepPartial<T[K]>;
};

该类型能自动处理数组：T[K] 若为 Bar[]，则 DeepPartial 展开为 (DeepPartial)[]；而 DeepPartial 又进一步展开为 { bar?: string; foo?: string }（因 Bar extends Foo，其属性合并后推导出完整可选集）。

Scrapfly SDK TypeScript

使用 Scrapfly SDK（scrapfly-sdk）在 TypeScript 或 JavaScript 中进行网页抓取，用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。

下载

应用到 Baz 类中：

class Baz {
  bars: Bar[];
  constructor({ bars = [] }: DeepPartial<Baz> = {}) {
    this.bars = bars.map(bar => new Bar(bar)); // ✅ bar 类型为 DeepPartial<Bar>
  }
}

现在以下调用全部通过类型检查：

const foo = new Foo();           // { foo: "foo" }
const bar = new Bar({ foo: "x", bar: "y" });

const baz1 = new Baz({ bars: [foo] });   // ✅ Foo 满足 DeepPartial<Bar>（bar 可缺省）
const baz2 = new Baz({ bars: [bar] });   // ✅ Bar 完全匹配
const baz3 = new Baz({ bars: [{ foo: "z" }] }); // ✅ 仅提供父类字段

⚠️ 注意事项与最佳实践

• DeepPartial 不处理函数或 Date 等非对象类型：默认将其视为不可递归（T[K] 原样保留），符合常规预期；
• 避免无限递归：TypeScript 会自动截断过深嵌套（通常 >50 层），实际项目中无需担心；
• 与构造函数逻辑对齐：确保 Bar 构造函数本身接受 Partial（如示例中已实现），否则 new Bar(bar) 仍会报错；
• 扩展性极强：无论 Baz 新增多少层嵌套（如 bars: { items: Bar[] }[]），DeepPartial 仍能自动适配，无需手动维护类型声明。

✅ 总结

相比硬编码 bars?: Partial[] 这种脆弱且不可复用的方式，DeepPartial 提供了真正泛型、可维护、符合类型系统直觉的解决方案。它是构建可配置、可组合、面向领域建模的 TypeScript 类库的关键基础设施之一。建议将其作为项目基础类型工具纳入 types/utils.ts 并全局复用。