如何自动将Flow注释类型转换为标准类型定义？

我之前也折腾过从Flow注释类型转到标准TS类型，手动改简直是噩梦，幸好有几个靠谱的自动化工具能帮你搞定这个事儿，不用逐行敲代码。下面给你介绍几个实用的方案：

1. 用flow-to-typescript工具直接转换 #

这个工具是专门针对Flow到TypeScript的转换开发的，能精准识别你这种注释式的类型标注，自动转换成TS的标准语法。

• 先安装工具：
  全局安装方便随时用：

  npm install -g flow-to-typescript
  

  或者局部安装到项目依赖里：

  npm install flow-to-typescript --save-dev
  

• 执行转换：
  转换单个文件：

  flow-to-typescript input.js output.ts
  

  批量转换整个目录的文件：

  flow-to-typescript src/ --out-dir src-ts/
  

  它会自动把你示例中的function upper(s/*: string*/)/*: string*/转换成function upper(s: string): string，变量的注释类型比如let name/*: string*/ = "Alice"也能转成let name: string = "Alice"，基础场景的转换准确率很高。

2. 用ts-migrate做一站式迁移 #

这是微软推出的迁移工具，专门帮项目从JS/Flow过渡到TypeScript，除了转换注释类型，还能帮你生成tsconfig.json、处理一些类型兼容问题，适合整个项目的迁移。

• 安装工具：

  npm install -g ts-migrate
  

• 在项目根目录执行迁移：
  先初始化TS配置：

  ts-migrate init
  

  然后执行文件转换和重命名：

  ts-migrate rename
  

  它会自动扫描项目里的Flow注释，转换成TS标准类型语法，之后你可能需要做一些小范围的微调，但大部分重复工作都能省下来。

3. ESLint自动修复辅助转换 #

如果你项目已经在用ESLint，可以配合相关规则实现自动修复。比如使用eslint-plugin-flowtype的转换规则，或者专门的迁移插件，然后执行：

eslint --fix src/

不过这个方案更适合小范围的调整，整个项目迁移的话还是前面两个工具更高效。

转换完成后，建议你跑一遍TypeScript的类型检查，有些复杂的Flow特有类型（比如$Exact）可能需要手动调整成TS的对应写法，但基础的函数、变量注释类型转换基本都能一次搞定。

内容的提问来源于stack exchange，提问作者doberkofler