类型声明文件管理规范

Tue, 04 Mar 2025 08:37:03 +0000

考察点分析

本题主要考察候选人在以下维度的能力：

具体技术评估点：

TypeScript类型查找策略 > typeRoots配置 > 模块声明合并 > 全局类型作用域

类型解析流程：
- 从导入语句开始，按照Node.js模块解析策略查找.d.ts
- 检查@types目录（当typeRoots未指定时默认包含）
- 递归查找当前文件目录直至项目根目录
- 解析tsconfig.json中paths配置的路径映射
typeRoots工作机制：
```
 {
 "compilerOptions": {
 "typeRoots": [
 "./custom_types", // 自定义类型目录
 "node_modules/@types" // 显式保留默认类型目录
 ]
 }
}
 
```
- 指定后只会扫描声明目录下的包结构（每个子目录视为一个包）
- 必须手动包含node_modules/@types否则丢失第三方类型

声明文件分类策略：

 types/
├── global # 全局类型声明
│ └── index.d.ts
├── modules # 模块扩展声明
│ └── react-native.d.ts
└── libs # 第三方库补丁类型
 └── legacy-lib.d.ts

规范管理类型声明文件需遵循以下策略：