如何扩展命名空间中声明的类？TypeScript 2.7继承编译错误解决

我之前在TS 2.7里用官方的module-class模板做类继承时，也踩过这个「属性不存在」的类型坑。本质上这大多是类型不匹配或模块导出/解析的问题，下面给你几个针对性的解决方案：

1. 检查并修正类的导出/导入方式 #

如果你的父模块是用官方模板的CommonJS风格导出（比如export = MyModule），继承时的导入语法不对容易导致类型识别异常。建议改用ES模块风格的导出，让TypeScript能正确识别子类的类型：

父模块（MyModule.ts） #

// 改用ES模块的命名导出或默认导出
export class MyModule {
  foo() {
    return "bar";
  }
}

子类（ExtendedModule.ts） #

import { MyModule } from './MyModule';

// 明确继承并导出子类
export class ExtendedModule extends MyModule {
  baz() {
    return "qux";
  }
}

引用子类时 #

直接导入子类而非父类，确保实例的类型是ExtendedModule而非MyModule：

import { ExtendedModule } from './ExtendedModule';

const instance = new ExtendedModule();
instance.baz(); // 此时类型检查正常，不会报错

2. 避免将子类实例赋值给父类型变量 #

如果你不小心把子类实例赋值给了父类型的变量，TypeScript会严格按照父类的类型检查，自然找不到子类的属性：

// 错误示例：将子类实例赋值给父类型变量
const instance: MyModule = new ExtendedModule();
instance.baz(); // 这里必然报错：Property 'baz' does not exist on type 'MyModule'

解决方法：要么去掉父类型的显式声明，让TypeScript自动推断为子类类型；要么用类型断言临时转换：

// 方案A：自动推断类型
const instance = new ExtendedModule();
instance.baz(); // 正常

// 方案B：类型断言
const instance: MyModule = new ExtendedModule();
(instance as ExtendedModule).baz(); // 强制转换后可正常访问

3. 调整TypeScript配置（针对模块解析问题） #

TS 2.7中，如果你的项目混用了CommonJS和ES模块，可能导致默认导出的类类型识别错误。可以在tsconfig.json里开启以下配置，优化模块解析的类型兼容性：

{
  "compilerOptions": {
    "module": "commonjs",
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "strict": true // 开启严格类型检查，更早发现问题
  }
}

4. 手动更新类型定义文件（如果使用了.d.ts） #

如果官方模板附带了类型定义文件（.d.ts），而你扩展的子类没有更新对应的类型声明，也会导致类型错误。可以给子类添加对应的类型定义：

ExtendedModule.d.ts #

import { MyModule } from './MyModule';

declare class ExtendedModule extends MyModule {
  baz(): string;
}

export { ExtendedModule };

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