TypeScript将类作为接口使用时为何要求包含私有构造属性？

核心原因 #

TypeScript 对包含private/protected修饰符的类，不会使用常规的结构类型（鸭子类型）校验，而是切换为名义类型校验：只有该类本身或它的子类的实例，才会被判定为符合该类的类型，普通对象字面量无论结构是否匹配，都无法通过类型校验。

报错对应解释 #

第一个报错（缺少privateString） #

TS 做兼容性检查时，首先会要求结构覆盖类的所有成员（包括私有成员），你的对象字面量没有声明对应属性，因此直接提示属性缺失。

第二个报错（privateString不是私有属性） #

你手动给对象字面量添加的privateString是普通公共属性，和类内部声明的私有属性完全不是同一概念：TS 中类的私有属性是类作用域绑定的，只有类内部能访问、外部不可能声明出和类私有属性同标识的成员，因此哪怕你加了同名属性，也会被判定为不匹配。

解决方案 #

方案1：抽离公共接口（最推荐） #

如果你需要做测试Stub、或者依赖的是类的对外能力，建议把类的对外方法抽成独立接口，用接口作为类型标注，完全避开私有成员的校验：

interface MyInterface {
  method1(): number;
  method2(): number;
}

class MyClass implements MyInterface {
  constructor(
    private privateString: string,
  ) {}
  method1(): number {
    return 1;
  }
  method2(): number {
    return 2;
  }
}

// 此时Stub只要匹配接口结构即可，不用关心类的私有属性
const Stub: MyInterface = {
  method1: () => 1,
  method2: () => 2,
};

方案2：子类继承实现Stub #

如果必须要使用MyClass作为类型，可以继承MyClass创建Stub子类，满足名义类型的校验要求：

class StubMyClass extends MyClass {
  constructor() {
    // 给父类私有构造参数传任意mock值即可
    super('mock-string');
  }
  // 按需重写父类方法
  method1 = () => 1;
  method2 = () => 2;
}

const Stub: MyClass = new StubMyClass();

方案3：类型断言绕过校验（适合临时测试场景） #

如果只是临时写测试、不想改现有类型定义，可以用双重断言直接绕过TS检查：

const Stub = {
  method1: () => 1,
  method2: () => 2,
} as unknown as MyClass;

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