第225题：类型定义文件 .d.ts 如何放置？

Question

TypeScript 是 JavaScript 类型的超集，它的扩展名是 .ts。

1. TypeScript 是一门强类型语言，它的变量在使用前，都必须声明类型。
2. TypeScript 可以将大量变量的类型声明统一提取到单独的文件，此类文件被称为声明文件，它的文件扩展名是 .d.ts，它可以被 TypeScript 解释器读取，并且能直观地表示出各种变量的使用方式。
3. 由于 TypeScript 是 JavaScript 的超集，所以声明文件也能用来表示 JavaScript 脚本的使用方式。
4. 一般来讲，组织声明文件的方式取决于库是如何被使用的。

传送门：https://www.tslang.cn/docs/handbook/declaration-files/introduction.html

如何引用

在你需要声明的 .js 或 .ts 文件的同一位置，插入你的同名 .d.ts 文件。

1、package.json 文件有一个 types（或 typings）属性专门用来定义 main 入口文件的声明文件路径。

2、npm 仓库里有一个 @types 组织，专门用来存放库的声明文件，引用时只需要安装 npm install --save-dev @types/库名 即可。

• 所有人都可以申请将自己的所有声明文件按规范提交到 @types 中去。例如：jest 测试库的声明文件就储存在 @types/jest 中。
• @types 下面还有很多底层类的声明文件，比如 Number、String 等在 @types/code-js 里都有声明。
• 传送门：https://github.com/DefinitelyTyped/DefinitelyTyped
• 在声明文件中使用 /// <reference types="..." /> 头，来引入依赖的其它声明。types 指某个其它声明的库，而不是声明文件的路径。

问题

问：为什么我在编辑器中选择 Promise 类进行溯源，会给我打开了一个 lib.es2015.promise.d.ts 文件？其中有对 Promise 的声明。而我的项目中明明没有这个文件。

答：因为你的项目或者编辑器，通过某种引用方式（上面的 3 或 4 方式），引用了这个声明文件。

Answer 1

按项目模块放