TypeScript 声明文件

TypeScript 声明文件（Declaration Files）用于描述已有 JavaScript 代码库的类型信息，以便 TypeScript 能够理解和对其进行类型检查。这对于在 TypeScript 中使用第三方 JavaScript 库或在项目中使用不具备 TypeScript 类型定义的模块非常有用。以下是 TypeScript 声明文件的详细介绍和使用方式：

1. 声明文件的作用

TypeScript 的类型系统需要了解每个变量、函数、类和模块的类型。对于 JavaScript 代码库，特别是那些没有原生支持 TypeScript 的第三方库，TypeScript 需要额外的声明文件来描述这些库的类型信息。声明文件告诉 TypeScript 每个符号的类型、结构和如何使用它们。

2. 使用声明文件

通过 DefinitelyTyped

大多数常见的第三方 JavaScript 库都已经有了相应的声明文件，这些声明文件通常托管在 DefinitelyTyped 社区。可以通过以下几种方式获取和使用声明文件：

npm 安装：很多声明文件都已经发布到 npm 上，可以通过 @types 包前缀进行安装。
```
npm install @types/lodash --save-dev
```
手动下载：可以直接从 DefinitelyTyped 的 GitHub 仓库手动下载声明文件，并将其放置在项目中。

编写自定义声明文件

如果要使用的库没有相关的声明文件，或者需要自定义类型声明，可以编写自己的声明文件。

文件命名约定：声明文件通常以 .d.ts 为后缀，比如 my-module.d.ts。

声明文件语法：使用 TypeScript 的声明语法描述变量、函数、类、接口等的类型信息。

// Example: my-module.d.ts
declare module 'my-module' {
  export function myFunction(x: number): number;
  export const myVariable: string;
  export interface MyInterface {
    method(): void;
  }
}

全局变量声明：描述全局变量的类型信息。

// Example: global.d.ts
declare var MY_GLOBAL: string;

3. 使用声明文件的注意事项

全局声明：如果声明文件定义了全局变量或全局模块，在使用之前需要确保它们在全局作用域中可用。
模块声明：如果声明文件定义了模块内的类型信息，需要使用 import 或 require 来导入声明的类型。
类型合并：可以通过声明合并（Declaration Merging）来扩展已有类型的定义。

4. 示例应用

假设有一个 JavaScript 库 my-module，我们想在 TypeScript 中使用它，但是它没有类型定义文件：

// my-module.js
function myFunction(x) {
  return x * 2;
}

module.exports = {
  myFunction
};

为了在 TypeScript 中使用，我们可以编写一个声明文件 my-module.d.ts：

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

然后在 TypeScript 项目中导入和使用该模块：

// main.ts
import { myFunction } from 'my-module';

const result = myFunction(3); // result: 6
console.log(result);

https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html