如何确定未标注Node版本的React.js项目适配的Node版本？

我太懂这种踩坑的滋味了——碰到没写Node版本的旧项目，全靠记性撑着真的慌，不把版本标注清楚绝对是糟糕的开发实践，给后续维护者挖了个大坑。针对你问的「无文档标注Node版本的React项目怎么确定版本」，分享几个实用的方法：

• 从React版本反推兼容的Node范围
  先看项目package.json里的react和react-dom版本号，React官方对Node版本有明确的兼容要求：

  • React 18.x：要求Node.js 14.0.0及以上
  • React 17.x：最低支持Node.js 12.0.0
  • React 16.x：最低支持Node.js 8.10.0
    先锁定React版本，就能得到一个Node版本的大致范围。

• 从锁文件找依赖的版本线索
  打开package-lock.json或yarn.lock，里面会记录所有依赖的具体版本。很多核心依赖（比如babel-loader、webpack、eslint）本身对Node版本有严格要求，你可以搜索锁文件里的engines字段，或者查这些依赖版本对应的Node兼容要求，缩小Node版本的范围。

• 查看项目配置文件的隐含信息
  比如.babelrc、webpack.config.js里的插件版本，老版本的@babel/preset-react可能只支持低版本Node；如果项目是用create-react-app初始化的，看package.json里react-scripts的版本：

  • react-scripts@5.x要求Node 14.0+
  • react-scripts@4.x最低支持Node 10.16
    这些配置文件能帮你进一步锁定版本。

• 用版本管理工具逐步试错
  用nvm或者n这类Node版本管理工具，先从React对应范围的LTS版本开始测试。比如先装14.x的LTS版本，运行npm install，如果能正常安装依赖，再跑npm start看项目能不能启动。如果安装时出现依赖兼容错误（比如提示「某包需要Node >=12」），就根据错误提示调整版本就行。

• 挖掘项目历史记录里的线索
  翻翻项目的Git提交记录，说不定旧的commit message里提过Node版本；或者看看CI配置文件（比如.github/workflows下的.yml文件），CI环境里一般会明确指定运行的Node版本，这是非常靠谱的参考。

最后提醒一句：搞定版本后，一定要把正确的Node版本加到package.json的engines字段里，比如：

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

别让后面的开发者再遭同样的罪啦！

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