Airbnb 是如何从 JavaScript 迁移到 TypeScript 的？

• 跨项目的一致性：一次性全部迁移将保证每个文件的状态相同，工程师不必记住他们可以在哪里使用 TypeScript 特性，以及编译器在哪些地方会报错。

• 只修复一种类型比修复文件容易地多：修复整个文件可能非常复杂，因为文件可能有许多依赖。使用混合迁移，更难追踪迁移的实际进度和文件的状态。

{
  "extends": "../typescript/tsconfig.base.json",
  "include": [".", "../typescript/types"]
}

• ts-migrate

• ts-migrate-server

• ts-migrate-plugins

• 升级 TypeScript 版本

• 对代码库进行重大更改或重构

• 改进一些常用库的类型

• TSServer: 这部分与 VSCode 编辑器在编辑器与语言服务器之间进行通信时所做的非常相似。TypeScript 语言服务器的一个新实例作为一个单独的进程运行，开发工具使用语言协议与服务器通信。

• Migration runner: 这部分运行并协调迁移过程。它需要以下参数：

interface MigrateParams {
  rootDir: string;          // path to the root directory  
  config: MigrateConfig;    // migration config, including list of       
                            // plugins it contains
  server: TSServer;         // an instance of the TSServer fork
}

1. 解析 tsconfig.json。

2. 创建.ts 源文件。

3. 将每个文件发送到 TypeScript 语言服务器进行诊断。编译器为我们提供了三种类型的诊断：语义诊断（semanticDiagnostics ）、语法诊断（syntacticDiagnostics ）和推理诊断（suggestionDiagnostics ）。我们使用这些诊断来发现源代码中有问题的地方。根据唯一的诊断编号和行号，我们可以确定潜在的问题类型并进行必要的代码修改。

4. 在每个文件上运行所有插件。如果文本由于插件的执行而改变，我们就更新原始文件的内容，并通知 TypeScript 语言服务器该文件已经改变。

• 基于 jscodeshift 的插件

• 基于 TypeScript 抽象语法树的插件

• 基于文本的插件

function mult(first, second) {
  return first * second;
}

转换为：
function tlum(tsrif: number, dnoces: number): number {
  console.log(`args: ${arguments}`);
  return tsrif * dnoces;
}

• 反转了所有标识符 first -> tsrif

• 向函数声明添加了类型 function tlum(tsrif, dnoces) -> function tlum(tsrif: number, dnoces: number): number

• 插入 console.log(‘args:${arguments}’);

const fn2 = function(p3, p4) {}
const var1 = [];

const fn2 = function(p3: any, p4: any) {}
const var1: any = [];

type Insert = { kind: 'insert'; index: number; text: string };
type Replace = { kind: 'replace'; index: number; length: number; text: string };
type Delete = { kind: 'delete'; index: number; length: number };

const str3 = foo
  ? // @ts-ignore
    // @ts-ignore comment
    bar
  : baz;

const str3 = foo
  ? bar
  : baz;

type Defined<T> = T extends undefined ? never : T;
type WithDefaultProps<P, DP extends Partial<P>> = Omit<P, keyof DP> & {
  [K in Extract<keyof DP, keyof P>]:
    DP[K] extends Defined<P[K]>
      ? Defined<P[K]>
      : Defined<P[K]> | DP[K];
};

// @ts-ignore ts-migrate(7053) FIXME: No index signature with a parameter of type 'string...
const { field1, field2, field3 } = DATA[prop];
// @ts-ignore ts-migrate(2532) FIXME: Object is possibly 'undefined'.
const field2 = object.some_property;

{*
// @ts-ignore ts-migrate(2339) FIXME: Property 'NORMAL' does not exist on type 'typeof W... */}
<Text weight={WEIGHT.NORMAL}>
  some text
</Text>
<input
  id="input"
  // @ts-ignore ts-migrate(2322) FIXME: Type 'Element' is not assignable to type 'string'.
  name={getName()}
/>

原文链接

https://medium.com/airbnb-engineering/ts-migrate-a-tool-for-migrating-to-typescript-at-scale-cd23bfeb5cc