为对象成员赋值时避免非空断言操作符的通用实现方案

安全阿岳

2026-7-14

避免非空断言的通用模型成员赋值方案

核心思路

通过定义允许属性为null/undefined的通用类型，结合类型守卫过滤无效值，实现类型安全的通用模型赋值逻辑——既不用非空断言!，也不用any丢失类型检查。

实现步骤

1. 定义通用NullablePartial类型

用来描述可能包含null/undefined的输入数据，比原生Partial<T>更贴合实际业务场景：

type NullablePartial<T> = {
  [K in keyof T]?: T[K] | null;
};

2. 优化ModelHelper工具类

添加类型守卫过滤null/undefined，让TypeScript自动推断赋值类型，无需强制类型转换：

export class ModelHelper {
  static set<T>(model: T, data: NullablePartial<T>): void {
    for (const key of Object.keys(data) as Array<keyof T>) {
      const value = data[key];
      // 过滤无效值，同时触发类型守卫
      if (value !== null && value !== undefined) {
        model[key] = value; // TypeScript自动识别value为T[keyof T]类型
      }
    }
  }
}

3. 在模型类中复用逻辑

每个模型只需一行代码实现setMembers，保持类型安全且无需重复编写赋值逻辑：

export class SomeModel {
  field1: string;
  field2: string;

  constructor({ field1 = "", field2 = "" } = {}) {
    this.field1 = field1;
    this.field2 = field2;
  }

  setMembers(data: NullablePartial<SomeModel>): void {
    ModelHelper.set(this, data);
  }
}

跨模型复用示例

任意模型都可以直接套用该逻辑，不受属性数量限制：

export class UserModel {
  id: number;
  username: string;
  email?: string;

  constructor({ id = 0, username = "", email } = {}) {
    this.id = id;
    this.username = username;
    this.email = email;
  }

  setMembers(data: NullablePartial<UserModel>): void {
    ModelHelper.set(this, data);
  }
}