升级Node.js到18.14.2后，如何更新React项目依赖适配新版本？

你的操作误区 #

• nvm install ... --reinstall-packages-from参数的作用是迁移全局npm包（比如你全局安装的vue-cli、webpack-cli这类工具），和项目本地的node_modules完全无关，所以这个命令本来就不会处理项目依赖，你误解了参数的用途。
• 执行rm -rf node_modules && npm i只是重新安装了package.json/package-lock.json里记录的旧版本依赖，并没有升级依赖到适配Node.js 18的版本，因此会出现peer依赖不兼容、包弃用提示以及漏洞问题。

正确的项目依赖升级流程（适配Node.js 18） #

1. 确认Node.js版本切换成功
   执行以下命令，确保当前环境使用的是目标版本：

   node -v
   npm -v
   

   输出应该对应v18.14.2和匹配的npm版本（你加了--latest-npm参数，通常是npm 9.x系列）。

2. 升级项目依赖到兼容版本

   • 先备份package.json和package-lock.json，避免操作失误无法回滚。
   • 先升级依赖声明范围内的最新小版本：

     npm update
     

   • 如果需要跨大版本升级（比如从2.x升到4.x），可以借助工具批量更新：
     先全局安装依赖更新工具：

     npm install -g npm-check-updates
     

     更新package.json里的依赖版本到最新兼容版：

     ncu -u
     

     最后重新安装依赖：

     rm -rf node_modules package-lock.json
     npm install
     

3. 处理peer依赖警告

   • peer依赖警告是因为某个包要求你的项目必须安装指定版本的另一个包，比如A包要求react@^18.0.0，但你项目里是react@17.x。
   • 根据警告信息里的具体要求，手动安装对应兼容版本，例如：

     npm install react@^18.0.0 --save
     

   • 如果是不影响核心功能的旧包警告，也可以临时用npm install --legacy-peer-deps跳过，但长期来看建议升级到兼容版本。

4. 修复漏洞

   • 执行命令查看漏洞详情：

     npm audit
     

   • 自动修复可修复的漏洞：

     npm audit fix
     

   • 若自动修复无效，根据漏洞提示手动升级存在问题的包到安全版本，例如：

     npm install vulnerable-package@safe-version --save
     

5. 验证项目运行
   启动项目，检查是否存在运行时错误（比如Node.js 18新增/废弃的API导致旧包报错），根据报错信息调整对应依赖或少量代码。

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