ts-migrate：Airbnb进行大规模TypeScript迁移的神器

这是奶爸码农第71篇原创文章，点击上方蓝字关注

引言

业界对于TypeScript已经是政治正确的选择了，越来越多的前端库/框架均采用TS，例如Ant Design 4.0、Vue 3.0等。同时，TS也提供了更健全的语法能力、静态的代码类型检查、更友好的代码辅助提示等等。

早在2019年，Airbnb就已经在JSConf上分享了其要对现有前端项目进行大规模TypeScript迁移转换的计划。但是对于现有项目进行TypeScript转换并不是一件轻松，Airbnb总共有超过200万行代码，超过100个内部npm包。

迁移策略

大规模代码迁移往往是一项非常复杂的工作，Airbnb探索过几个迁移策略：

• 混合迁移策略：一个个文件进行迁移，修复类型错误。allowJS配置可以允许JS和TS文件在一个项目中并存。使用混合迁移策略可以不用暂停当前开发，逐步的一个个文件进行迁移。但是，对于研发人员需要更长的适应和迁移时间。

• 完全迁移策略：一次性实现文件完全迁移。我们会使用any或者@ts-ignore注释帮助项目编译，随后会补充更加具体的类型申明。

采用完全迁移策略有很多的好处：

• 项目的一致性：在完全迁移策略下，项目使用使用TypeScript来编写，因此，开发者并不需要在JS和TS之间进行切换。

• 修复类型比修复文件容易：修复一个完整文件非常复杂，因为它可能有很多外部依赖，因此，采用混合迁移的方式，很难保证迁移的进度和状态。

因此，Airbnb采用了完全迁移策略。然而，一次性迁移完整项目难度非常大。Airbnb研发了一个转换工具：ts-migrate，在初试转换过程中，尽可能实现类型的自动转换。

当然，这个工具并不能保证实现完全没有错误的转换，但是在实际使用过程中，对于一个超过50000行代码、1000个文件的项目，从JavaScript转换到TypeScript使用这个工具往往只需要1天！

在Airbnb，React是主要前端框架，所以主要的codemods转换都是基于React概