如何将React项目中的Node.js版本从14.x.x升级至19.x.x？

1. 预检查：确认依赖兼容性 #

• 执行 npm outdated 查看项目依赖的版本状态，标记出明确不支持 Node.js 16+ 的老旧包（比如部分 webpack@4 版本、旧版 babel 插件等）
• 优先将这些不兼容包升级到官方声明支持 Node.js 19 的最新版本，避免后续安装或运行时出现报错

2. 升级 Node.js 版本 #

推荐使用版本管理器来切换版本，避免全局环境混乱：

• 使用 nvm：
  • 安装 19.x.x 最新版：nvm install 19
  • 切换到该版本：nvm use 19
  • 可选：设置为默认版本（新终端窗口自动使用）：nvm alias default 19
• 使用 n：
  • 全局安装 n（未安装过的话）：npm install -g n
  • 安装并切换到 19.x.x：n 19
• 直接安装（不推荐）：
  下载 Node.js 19.x.x 安装包覆盖现有版本（注意：全局 npm 包可能需要重新安装）

3. 更新项目的 engines 配置 #

打开项目根目录的 package.json，修改 engines 字段为：

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

这个配置可以明确告知协作成员和部署环境所需的 Node.js 版本要求

4. 验证项目正常运行 #

• 删除项目根目录的 node_modules 文件夹和 package-lock.json（或 yarn.lock）文件
• 重新安装依赖：npm install（或 yarn install）
• 启动开发服务：npm start，检查是否能正常启动且无报错
• 运行测试脚本：npm test，确保所有测试用例通过
• 执行生产构建：npm run build，确认构建产物正常生成

注意事项 #

• Node.js 19 是奇数版本，属于非长期支持（LTS）版本，若需生产环境长期稳定，后续可考虑升级到 20.x.x（LTS 版本）
• 若遇到依赖安装或运行报错，优先查看对应包的官方文档，确认是否有兼容 Node.js 19 的版本，或寻找替代方案
• 部分 Node.js 14 中可用的 API 在 19 版本已被废弃，若运行时出现相关报错，需针对性修改代码

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