执行npm run deploy部署GitHub时报错Cannot read property 'includes' of undefined

问题根因 #

你当前使用的react-scripts@4.0.3内置依赖为webpack 4版本，你手动安装的webpack 5、webpack-dev-server 4、html-webpack-plugin 5和内置版本出现了兼容性冲突，引发了编译阶段的Cannot read property 'includes' of undefined报错。

解决方案 #

• 第一步：卸载冲突的手动安装依赖
  执行命令：

npm uninstall webpack html-webpack-plugin webpack-dev-server

如果你后续仍出现sass相关编译报错，可额外卸载非必要的sass-loader：

npm uninstall sass-loader

react-scripts已经内置了webpack、sass-loader等构建相关依赖，无需手动安装额外版本。

• 第二步：清理冗余文件与缓存
  删除项目根目录下的node_modules文件夹、package-lock.json文件，再执行缓存清理命令：

npm cache clean --force

• 第三步：重新安装依赖

npm install

• 第四步：测试构建与部署
  先执行本地构建命令验证是否正常：

npm run build

构建无报错后再执行部署命令即可：

npm run deploy

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