为何TypeScript模块扩充后，MyTesterImpl仍不存在augmented属性？

问题的核心在于默认导出的类在模块扩充时的特殊处理规则：

当你使用export default class MyTesterImpl时，类的实例接口（描述类实例结构的类型）仅存在于模块内部，并未作为命名成员导出。你当前的模块扩充代码声明的interface MyTesterImpl是模块内部的新接口，无法和类的实例接口合并。

解决方案一：改用命名导出（最直观可靠） #

将类改为命名导出，类的实例接口会被明确导出，模块扩充的同名接口就能正常合并：

1. 修改MyTesterImpl.ts：

export class MyTesterImpl { // 去掉default，改用命名导出
  public basicA: string;
  public basicB: string;

  constructor(a: string, b: string) {
    this.basicA = a;
    this.basicB = b;
  }

  showStuff() {
    console.log(`${this.basicA} ${this.basicB}`);
  }
}

2. 修改index.ts的导入逻辑（扩充代码无需改动）：

import { MyTesterImpl } from "./MyTesterImpl"; // 改为命名导入

declare module "./MyTesterImpl" {
  interface MyTesterImpl {
    augmented: boolean;
  }
}

const main = async (): Promise<void> => {
  // 正确创建类实例，而非用对象字面量断言
  let testy = new MyTesterImpl("hey", "there");
  testy.augmented = true; // 此时无编译错误
};

main();

解决方案二：保留默认导出，调整模块扩充写法 #

如果必须保留默认导出，需要在模块声明中重新导出默认值，让TypeScript将扩充的接口与类的实例类型关联：

修改index.ts：

import MyTesterImpl from "./MyTesterImpl";

declare module "./MyTesterImpl" {
  interface MyTesterImpl {
    augmented: boolean;
  }

  // 重新导出默认值，确保接口合并生效
  export default MyTesterImpl;
}

const main = async (): Promise<void> => {
  let testy = new MyTesterImpl("hey", "there");
  testy.augmented = true;
};

main();

额外注意点 #

你原来用{ basicA: "hey", basicB: "there" } as MyTesterImpl的方式存在风险：这个对象仅包含类的实例属性，但没有类原型上的showStuff方法，本质上并不是MyTesterImpl的实例。正确的实例创建方式应该使用new关键字。

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