升级Node.js至16.18.1 LTS后，如何查找React项目兼容依赖版本？

1. 用npm内置命令查询包的兼容Node版本 #

• 要查看某个依赖包声明的Node版本要求，直接执行：

  npm view <package-name> engines
  

  比如查询React的兼容范围：npm view react engines，返回结果会明确标注该包支持的Node版本范围，你可以对照16.18.1 LTS挑选合适的包版本。
• 升级Node后直接执行npm install，若存在不兼容依赖，npm会抛出明确错误提示，其中会说明该依赖所需的Node版本，据此调整package.json里的对应包版本即可。

2. 利用package.json的engines字段管控 #

• 在项目package.json中添加engines字段，明确指定Node版本要求：

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

  然后执行npm install --engine-strict，npm会严格按照该Node版本筛选依赖，不符合要求的包会直接报错，方便快速定位不兼容项。
• 若想查看某个特定版本依赖的兼容要求，执行：

  npm view <package-name>@<version> engines
  

3. 用npm-check-updates批量筛选兼容更新 #

• 安装工具后，它会自动检测当前依赖可升级到的、兼容指定Node版本的最新版本：

  npm install -g npm-check-updates
  ncu --target minor  # 升级到次版本号最新
  # 或者直接更新到所有兼容的最新版本
  ncu -u
  

  注意：操作前务必备份package.json和package-lock.json，先在测试环境验证升级后的项目运行情况。

4. 参考React生态工具的官方兼容规则 #

• React核心包：React 18及以上版本支持Node.js >=14.0.0，完全兼容16.18.1 LTS，可放心升级到最新稳定版。
• 配套工具如webpack 5、babel 7均支持Node.js >=10.13.0，与16.18.1无兼容冲突，可直接升级到对应最新稳定版。

实操步骤建议 #

1. 备份项目的package.json和package-lock.json文件，避免升级故障无法回滚。
2. 删除本地node_modules和package-lock.json，执行npm install，收集所有不兼容的依赖报错信息。
3. 针对每个报错的依赖，用上述方法查询兼容版本，修改package.json中的版本号。
4. 重新执行npm install，启动项目测试所有功能是否正常运行。

内容的提问来源于stack exchange，提问作者P.N.Jayasinghe