关注点分离
使用 .d.ts 文件的一个关键原因是保持类型定义和实现代码之间的清晰分离。这在处理大型代码库或开发供他人使用的库时尤为有用。通过将类型隔离在 .d.ts 文件中，你可以保持实现的清晰和专注，同时让他人更容易理解你的模块的 API 表面。示例：
通过 .d.ts 文件，干净地将契约与实现分开。
库开发
如果你正在开发一个供其他 TypeScript 或 JavaScript 项目使用的库，.d.ts 文件是不可或缺的。它们允许你公开一个定义良好的 API，而不会泄露实现细节。当他人安装你的库时，得益于这些声明文件，他们可以在使用时获得完整的 IntelliSense 支持和类型安全。在发布库时，将 .d.ts 文件包含在你的包中，可以让使用者获得类型信息，而无需转译你的代码或深入研究实现。
第三方库集成
通常，我们会使用并非用 TypeScript 编写的 JavaScript 库。为了利用 TypeScript 的类型检查，我们需要描述这些库提供的对象和函数的形状。这时 .d.ts 文件就派上了用场。许多流行的库，如 jQuery 或 Lodash，都有在 DefinitelyTyped 仓库中维护的社区版本的 .d.ts 文件，可以通过 npm 安装。示例：
```
npm install @types/lodash
```
一旦安装，TypeScript 即可对 Lodash 的使用进行类型检查，尽管 Lodash 本身不是用 TypeScript 编写的。
大型项目中的性能提升
在大型项目中，将类型定义放在 .d.ts 文件中可以帮助提高性能。TypeScript 的编译器可以比普通 .ts 文件更快地分析这些文件，因为 .d.ts 文件不包含实际的实现代码。它们只描述类型，从而简化了编译过程。

何时使用 .d.ts 文件而不是普通 .ts 文件

尽管 .d.ts 文件非常有用，但它们并不总是最佳选择。

有时，将类型和接口直接存储在 .ts 文件中更为合理，尤其是在你正在处理一个内部项目时，分离实现和类型并不那么重要。

在以下情况下使用 .d.ts 文件：

开发库：如前所述，如果你的代码将被他人使用，使用 .d.ts 文件来公开一个干净的 API 是最佳实践。
与 JavaScript 库进行接口对接：当你需要描述第三方 JavaScript 库提供的类型时。
隔离类型定义：如果你希望通过将类型与实现分离来保持项目的组织，尤其是在大型项目中或类型在许多模块中复用时。

在以下情况下坚持使用 .ts 文件：

内部项目：如果你的项目是内部使用的，并且不需要单独公开类型，保持所有内容在 .ts 文件中可能更简单。
小型项目：在小型项目中，维护单独的 .d.ts 文件的开销可能不值得。
快速原型开发：当你在项目中快速迭代时，将类型与实现放在同一文件中可以避免上下文切换，从而更快。

2024 年使用 .d.ts 文件的最佳实践

利用 TypeScript 的 declare 关键字
在编写 .d.ts 文件时，记住你不需要使用 export 关键字，除非你在处理模块。相反，使用 declare 表示类型和接口是全局可用的。示例：
```
declare interface MyInterface {
  name: string;
  age: number;
}
```
保持 .d.ts 文件的简洁
.d.ts 文件的美妙之处在于其简洁性。它们只应包含类型声明——别无其他。避免在这些文件中包含逻辑或初始化代码的诱惑。
谨慎使用 /// <reference /> 指令
虽然可以使用 /// <reference /> 指令链接 .d.ts 文件，但尽量避免，除非绝对必要。相反，依赖 TypeScript 的模块解析来管理类型文件之间的依赖关系。
逻辑地组织类型声明
按照与你项目架构相匹配的方式组织 .d.ts 文件。例如，将全局类型放在一个 globals.d.ts 文件中，将模块特定的类型放在各自模块目录中的 .d.ts 文件中。