TypeScript接口属性未强制类实现同时包含getter与setter的类型检查问题

你遇到的确实是TypeScript在4.4.0-beta及更早版本里的一个类型检查疏漏，属于编译器对接口属性与类访问器兼容性处理的不对称问题。

先看你提供的代码示例：

interface IMyInterface { property1: string; }
class MyClassWithSetterOnly implements IMyInterface { // <--- 预期报错：property1缺少getter
    private _property1: string = 'default';
    set property1(v: string) { this._property1 = v; }
}
class MyClassWithGetterOnly implements IMyInterface { // <--- 预期报错：property1缺少setter
    private _property1: string = 'default';
    get property1(): string { return this._property1; }
}

const setterOnly = new MyClassWithSetterOnly();
const getterOnly = new MyClassWithGetterOnly();

setterOnly.property1 = 'value';
getterOnly.property1 = 'value'; // <--- 符合预期报错：property1缺少setter
console.log(setterOnly.property1); // <--- 预期报错：property1缺少getter
console.log(getterOnly.property1);

问题根源 #

在早期TypeScript版本中，编译器对接口普通属性的检查逻辑存在两个核心问题：

• 当类仅实现接口属性的setter或getter时，没有正确识别这不符合接口对属性"可读可写"的隐含要求，因此未触发实现错误。
• 实例访问时的检查不对称：仅含getter的实例赋值会触发错误，但仅含setter的实例取值却不会——这是因为编译器对setter属性的读取操作没有做严格的类型校验。

官方情况与解决方案 #

这个问题属于TypeScript早期的已知设计疏漏，后续在TypeScript 4.4正式版及更高版本中已经修复了这类不一致的检查逻辑：

1. 新版本编译器会正确识别：当接口声明普通属性时，类必须提供同时支持读写的实现（要么是普通实例属性，要么同时包含getter和setter），仅实现其中一个访问器会触发实现错误。
2. 实例访问时的检查也会对称：仅含setter的属性被读取时，编译器会触发"属性没有getter"的错误。

如果你无法升级TypeScript版本，可以通过以下方式手动规避：

• 明确接口的访问器要求：把接口定义改为显式声明getter和setter，让旧版本编译器强制类实现两者：

  interface IMyInterface {
      get property1(): string;
      set property1(v: string);
  }
  

• 拆分接口：根据读写需求拆分出只读和只写接口，让类按需实现，类型检查会更精准：

  interface IReadableMyInterface {
      readonly property1: string;
  }
  interface IWritableMyInterface {
      property1: string;
  }
  
  class MyClassWithGetterOnly implements IReadableMyInterface {
      private _property1: string = 'default';
      get property1(): string { return this._property1; }
  }
  

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