09 类型声明文件

类型声明文件（.d.ts） #

类型声明文件用于为 JavaScript 代码提供 TypeScript 类型定义，而不包含实际实现。

基本概念 #

.d.ts 文件仅包含类型信息、接口、类型别名等，用于类型检查和智能提示。它们不生成 JavaScript 代码。

使用场景 #

  • 为第三方 JavaScript 库添加类型支持。
  • 在模块化项目中分离类型定义。
  • 全局变量或函数的类型声明。

示例代码 # 

// global.d.ts
declare var GLOBAL_VAR: string;
declare function globalFunction(): void;

// module.d.ts
declare module 'my-module' {
  export function myFunction(param: number): string;
}

最佳实践 #

  • 使用 declare 关键字声明类型，而不提供实现。
  • 组织声明文件以匹配模块结构。
  • 结合 DefinitelyTyped 仓库获取现成声明文件。
  • 在 tsconfig.json 中配置 include 以包含声明文件。