React项目安装依赖出现npm WARN deprecated废弃警告该如何正确处理？

1. 先做风险分级，优先处理高危警告 #

首先执行npm ls <废弃包名> 确认包的依赖来源，区分是项目直接依赖还是间接依赖（依赖的依赖），优先处理明确标注了运行风险的警告：

• 功能崩溃类：例如chokidar@2.x会在Node14+版本运行报错，必须优先处理
• 性能/安全类：例如core-js@<3.3可能导致百倍性能下降、uuid@3.x存在随机数安全隐患，建议尽快处理
• 仅无维护提示类：例如旧版@hapi系列工具包、flatten等，未明确标注风险的可以延后处理

2. 处理直接依赖的废弃包 #

如果npm ls查询后确认废弃包是你在package.json里直接声明的依赖，按照警告提示直接替换/升级即可：

• 替换更名的包：例如babel-eslint替换为@babel/eslint-parser、rollup-plugin-babel替换为@rollup/plugin-babel、@hapi/joi替换为joi、@hapi/address替换为@sideway/address
• 升级到推荐版本：例如uuid升级到7+、chokidar升级到3+、core-js升级到3.3以上的最新稳定版
• 废弃API替换：项目中使用querystring的逻辑，替换为原生的URLSearchParams API实现
• 完成修改后重新执行npm install，并跑通项目所有测试用例，确认功能不受影响

3. 处理间接依赖的废弃包 #

如果废弃包是上层依赖的子依赖，自己无法直接修改版本，按以下步骤处理：

• 先升级对应的上层依赖：例如脚手架、构建工具、lint工具等，通常官方会在新版本中及时更新废弃的子依赖，升级后警告会自动消除
• 若上层依赖暂无更新，可以在package.json中添加overrides配置强制指定子依赖版本，示例如下：

{
  "overrides": {
    "chokidar": "^3.6.0",
    "core-js": "^3.37.0"
  }
}

配置完成后删除node_modules文件夹和package-lock.json文件，重新执行npm install即可

• 强制覆盖子依赖版本后必须做全量功能测试，避免版本不兼容导致功能异常

临时屏蔽方案（不推荐） #

如果当前项目运行稳定，暂时没有时间处理警告，可以在执行npm安装命令时添加参数仅输出错误信息，屏蔽警告：

npm install --loglevel error

该方案仅隐藏警告不会解决实际风险，建议后续有空及时完成依赖升级。

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