32、JavaScript 项目迁移至 TypeScript 的实用指南

JavaScript 项目迁移至 TypeScript 的实用指南

1. 前期准备要点

在将 JavaScript 项目迁移到 TypeScript 之前，有一些前期准备工作需要完成：
- 在 JavaScript 文件顶部添加 "// @ts-check" 以在不转换为 TypeScript 的情况下启用类型检查。
- 识别常见错误，了解如何声明全局变量以及为第三方库添加类型声明。
- 使用 JSDoc 注释进行类型断言和更好的类型推断。
- 不要花费过多时间使用 JSDoc 让代码达到完美的类型标注，记住最终目标是转换为 .ts 文件。

2. 使用 allowJs 混合 TypeScript 和 JavaScript

对于小型项目，可能一次性就能将 JavaScript 转换为 TypeScript。但对于大型项目，这种“一刀切”的方法并不适用，需要逐步过渡，这就要求 TypeScript 和 JavaScript 能够共存，而 allowJs 编译器选项就是关键。

2.1 allowJs 选项的作用

启用 allowJs 后，TypeScript 文件和 JavaScript 文件可以相互导入。对于 JavaScript 文件，这种模式非常宽松，除非使用 @ts-check ，否则只会看到语法错误，这体现了“TypeScript 是 JavaScript 的超集”这一特性。虽然它不