TypeScript泛型继承类键报错：IBaseModel递归引用自身为基类型

错误Type 'IBaseModel' recursively references itself as a base type.的核心原因是循环类型依赖：

• IBaseModel继承BaseEntity<IBaseModelKeys>
• 而IBaseModelKeys的定义是keyof Omit<IBaseModel, ...>，直接依赖未完全定义的IBaseModel类
  这种递归的基类型引用超出了TypeScript的类型解析能力，导致报错。

重构类型定义，打破循环依赖，同时保留get/set方法的类型安全：

1. 分离属性类型与类定义 #

先定义实体/模型的属性类型，再基于这些类型生成键类型，避免直接从类本身取键。

2. 调整BaseEntity的泛型设计 #

让BaseEntity接受属性类型而非键类型作为泛型参数，这样可以更灵活地约束get/set方法的类型。

// 定义IBaseEntity的属性类型
type IBaseEntityProps = {
  id: string;
  locked: boolean;
  namespace: string;
};

type IBaseEntityKeys = keyof Omit<IBaseEntityProps & EventTarget, keyof EventTarget>;

class IBaseEntity extends EventTarget implements IBaseEntityProps {
  id!: string;
  locked!: boolean;
  namespace!: string;
  protected readonly logPrefix!: string;

  constructor(logPrefix: string) {
    super();
    this.logPrefix = logPrefix;
  }

  override addEventListener(
    type: IBaseEntityKeys,
    callback: EventListenerOrEventListenerObject | null,
    options?: boolean | AddEventListenerOptions | undefined
  ): void {
    super.addEventListener(type, callback, options);
  }
}

// 让BaseEntity接受属性类型作为泛型参数，默认继承IBaseEntityProps
export class BaseEntity<T extends IBaseEntityProps = IBaseEntityProps> extends IBaseEntity {
  constructor(options: Partial<T> & { logPrefix?: string }) {
    super(options.logPrefix ?? '');
    // 合并属性到实例
    Object.assign(this, options);
    // 给未传入的属性设置默认值
    this.locked = options.locked ?? false;
    this.namespace = options.namespace ?? 'default';
  }

  // 基于泛型T约束get方法的键
  get<K extends keyof T>(key: K): T[K] {
    return this[key];
  }

  // 基于泛型T约束set方法的键和对应值类型
  set<K extends keyof T>(key: K, value: T[K]): void {
    (this as T)[key] = value;
  }
}

// 定义IBaseModel的属性类型，继承IBaseEntityProps
type IBaseModelProps = IBaseEntityProps & {
  parent: IBaseModel;
  selected: boolean;
  hovered: boolean;
  painted: boolean;
};

type IBaseModelKeys = keyof Omit<IBaseModelProps & EventTarget, keyof EventTarget | 'get' | 'set'>;

// IBaseModel继承BaseEntity，传入IBaseModelProps作为泛型参数
class IBaseModel extends BaseEntity<IBaseModelProps> implements IBaseModelProps {
  parent!: IBaseModel;
  selected!: boolean;
  hovered!: boolean;
  painted!: boolean;
}

export class BaseModel extends IBaseModel {
  constructor(options: Partial<IBaseModelProps> & { logPrefix?: string }) {
    super({ namespace: 'default', ...options });

    // 设置默认值
    this.selected = options.selected ?? false;
    this.hovered = options.hovered ?? false;
    this.painted = options.painted ?? false;
    this.parent = options.parent!;
  }
}

• 分离属性类型：通过IBaseEntityProps、IBaseModelProps提前定义类的属性结构，避免直接从类本身取键导致的循环依赖。
• 泛型参数调整：BaseEntity的泛型参数改为属性类型T，让get/set方法能直接基于T约束键和值的类型，保证类型安全。
• 类型安全增强：使用Partial<T>处理构造函数的options参数，同时保留默认值逻辑，避免any类型的滥用。

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