如何扩展flow-bin支持新Node.js方法？及flow-bin自身bug的临时解决办法

刚好我之前也遇到过类似的Flow类型适配问题，来给你详细解答这两个场景：

Flow对Node.js API的类型支持完全依赖它内置的libdef（类型定义文件），当官方还没更新适配新的Node.js方法时，你可以通过以下方式手动扩展：

• 本地自定义libdef文件（最推荐）：

  1. 在项目里创建一个自定义类型文件，比如放在src/flow-typed/node-custom.js.flow路径下
  2. 在这个文件里补充目标方法的类型声明，以你提到的Buffer#swap64为例，写法如下：

     declare class Buffer {
       // 按照Node.js文档，swap64返回自身，所以类型定义为返回this
       swap64(): this;
     }
     

  3. 修改项目根目录的.flowconfig，在[libs]区块里添加这个文件的路径：

     [libs]
     src/flow-typed/node-custom.js.flow
     

  这样Flow在检查类型时会自动加载你的自定义定义，就能识别新的Node.js方法了。

• 借助flow-typed社区资源：
  如果社区已经有人提交了对应Node.js版本的完整类型定义，你可以通过flow-typed install node@<你的Node版本>命令安装对应的类型包，但如果是非常新的API，可能还没有社区定义，这时候还是自定义libdef更靠谱。

针对你提到的Flow v0.62不识别Buffer#swap64的情况，确实是当时Flow的内置libdef没跟上Node.js的更新节奏。在等待官方PR合并期间，有几个不用分叉Flow项目的临时方案：

• 用$FlowFixMe注释快速跳过检查：
  在报错的代码行添加注释，明确说明忽略的原因，避免后续维护时产生困惑：

  // $FlowFixMe: Buffer.swap64已在Node.js v10+支持，Flow v0.62暂未更新类型定义
  int64buf.swap64() // turn into Little-Endian
  

  这个方法最快捷，适合单个调用场景临时使用。

• 类型断言强制指定类型：
  把变量断言成包含目标方法的自定义类型，让Flow认可该方法的存在，比$FlowFixMe更严谨一点：

  // 断言int64buf拥有swap64方法，返回Buffer类型
  (int64buf as { swap64(): Buffer }).swap64();
  

• 本地补充libdef（一劳永逸）：
  就是第一个问题里提到的自定义libdef方案，一次性给整个项目补上该方法的类型定义，不用在每个调用处单独处理，步骤和前面完全一致，适合项目中多处用到该方法的场景。

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