TypeScript子类仅声明父类方法不重实现的类型校验问题

我懂你要实现的需求：让子类继承QueryBuilder后，不用重写父类insert方法的逻辑，只通过类型声明约束调用时的参数类型，但现在碰到了「Function implementation is missing or not immediately following the declaration」的报错。这是因为TypeScript对类方法的声明和实现有严格要求——只写方法签名却没有实现的话，编译器会认定你遗漏了方法体。

下面给你两种可行的解决方案，你可以根据实际场景选择：

方案一：使用泛型父类（推荐） #

把父类QueryBuilder改成泛型类，子类继承时直接指定具体的类型参数，不用在子类里额外声明方法，就能自动获得类型约束：

// 泛型父类，T代表insert方法的参数类型
class QueryBuilder<T> {
  insert(data: T): string {
    return ''; // 父类的原有实现逻辑
  }
}

// 定义你的用户类型
interface IUser { 
  name: string; 
  email: string; 
}

// 子类继承时指定泛型为IUser
class UserQueryBuilder extends QueryBuilder<IUser> {}

// 使用示例
const userBuilder = new UserQueryBuilder();
userBuilder.insert({ name: "Alice", email: "alice@example.com" }); // 类型正确，正常调用
userBuilder.insert({ name: "Bob" }); // 报错：缺少email属性，符合预期

这种方式最简洁，完全利用TypeScript的泛型特性做类型约束，代码可读性和维护性都很强。

方案二：方法重载+复用父类实现 #

如果因为某些限制不能修改父类为泛型，你可以在子类里用方法重载的方式：先声明针对IUser的方法签名用于类型校验，再写一个调用父类实现的方法体，既保留类型约束，又不用重写逻辑：

class QueryBuilder {
  insert<T>(data: T): string {
    return ''; // 父类的原有实现逻辑
  }
}

interface IUser { 
  name: string; 
  email: string; 
}

class User extends QueryBuilder {
  // 声明针对IUser的重载签名，用于类型校验
  override insert(data: IUser): string;
  // 实现部分，直接复用父类的insert逻辑
  override insert<T>(data: T): string {
    return super.insert(data);
  }
}

// 使用示例
const user = new User();
user.insert({ name: "Alice", email: "alice@example.com" }); // 类型正确
user.insert({ age: 25 }); // 报错：类型不匹配IUser，符合预期

这里的override关键字是可选的，但加上它能明确表示你是重写父类方法，让代码逻辑更清晰。

为什么你的原写法会报错？ #

TypeScript中，如果你在子类里只写了方法签名（比如insert<IUser>(data: IUser): string;），编译器会默认你要提供一个新的方法实现，但你没有写方法体，所以就抛出了那个错误。必须让签名和实现对应起来，要么像方案二那样用重载，要么用泛型父类的方式避免单独声明签名。

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