TypeScript中同名Interface与Class共存无报错？求解释或确认是否为Bug

这不是TypeScript的Bug，而是**接口与类的声明合并（Declaration Merging）**特性导致的。

核心原因：TypeScript的声明合并机制 #

TypeScript允许同名的接口与类进行声明合并，合并后的类型会同时包含两者的成员：

• 接口的成员会被合并到类的类型定义中
• 类本身的实现只需要满足自身定义的成员，编译器不会强制要求类实现同名接口的成员（除非使用implements关键字）

具体代码分析 #

原代码中：

interface MyService {
  x: number;
  readonly m1: () => void;
  m2(): void;
}

class MyService {
  y: number = 0;
}

合并后的MyService类型同时包含接口的x、m1、m2和类的y。所以当你执行const a: MyService = new MyService()时，TypeScript会认为类的实例符合合并后的类型（尽管实际运行时实例并没有x、m1、m2），这是因为声明合并改变了类型检查的规则。

而当你把接口改名后：

interface AMyService {
  x: number;
  readonly m1: () => void;
  m2(): void;
}

class MyService {
  y: number = 0;
}

const a: AMyService = new MyService(); // 报错

此时没有声明合并，TypeScript会严格检查类的实例是否符合AMyService接口的要求，显然类缺少接口中的成员，所以抛出错误。

注意点 #

• 声明合并是TypeScript为了兼容JavaScript代码模式（比如扩展内置类或第三方库类型）设计的特性
• 如果需要强制类实现接口的成员，必须使用implements关键字，此时编译器才会检查类是否满足接口的所有要求

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