如何确定项目可正常运行的NodeJS最低兼容版本？

• 检查依赖与配置文件
  先看项目根目录的package.json，如果存在engines字段，里面通常会标注开发者指定的Node版本要求，示例：

  "engines": {
    "node": ">=14.0.0"
  }
  

  另外，查看node_modules里各依赖包的package.json，它们的engines字段会列出自身要求的最低Node版本，项目的最低版本至少要满足所有依赖的最高下限。

• 分析代码使用的特性
  梳理项目里用到的ECMAScript语法和Node.js内置API：

  • 比如用了可选链?.、空值合并??，需要Node.js 14.0.0及以上；
  • 用了顶级await，需要Node.js 14.8.0+；
  • 用到fs/promises完整API，需要Node.js 10.0.0+。
    对照Node.js特性支持情况，找出所有用到特性对应的最低版本，取其中最高的作为项目最低要求。

• 用工具手动/自动检测

  • 用nvm（Node版本管理器）逐个测试：通过nvm install <版本号>安装不同低版本Node，运行项目启动命令和测试用例，找到第一个能正常运行所有功能的版本；
  • 用semver包分析依赖：安装semver后编写简单脚本，遍历所有依赖的Node版本要求，计算出兼容的最低版本。

• 自动化测试验证
  在CI流程中配置多版本Node测试，比如在GitHub Actions里设置版本矩阵，运行项目测试套件，最终确定能通过所有测试的最低版本。

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