使用npm install安装React及依赖失败 出现弃用警告该如何解决

环境兼容性排查 #

日志中出现的chokidar@2.1.8报错明确提示该版本不支持Node v14以上版本，这是安装流程中断的核心原因之一：

• 执行node -v和npm -v查看本地环境版本，如果你使用的是3.x及更早版本的旧版create-react-app，必须搭配Node 12.x LTS版本才能正常安装；如果要使用Node 18.x/20.x等新LTS版本，不要使用已废弃的旧版全局create-react-app包初始化项目。

缓存清理重试 #

npm缓存损坏也会导致安装流程卡住，执行以下命令清理后重试安装：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

如果仍存在依赖冲突导致安装失败，可临时添加参数兼容旧依赖规则（仅临时调试使用，不建议长期开启）：

npm install --legacy-peer-deps

手动升级旧依赖 #

如果是现有项目的package.json中直接依赖版本过旧，可按照警告提示逐一升级对应包：

• 替换babel-eslint为@babel/eslint-parser
• 替换eslint-loader为eslint-webpack-plugin
• 将html-webpack-plugin升级到4.x/5.x正式稳定版
• 将core-js升级到3.3及以上版本
• 替换@hapi/joi为官方新维护包joi

新项目推荐初始化方式 #

如果是新建React项目，使用官方推荐的现代化脚手架初始化，可完全避免旧依赖导致的警告和安装失败问题：

• Vite初始化命令：npm create vite@latest my-react-app -- --template react
• Next.js初始化命令：npx create-next-app@latest my-react-app

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