执行NPM react build时收到不存在的错误提示该如何解决

构建报错排查解决方案 #

• 清理项目冗余缓存：先删除根目录下的node_modules文件夹、package-lock.json/yarn.lock/pnpm-lock.yaml依赖锁文件，执行npm cache clean --force清理npm全局缓存，之后重新执行npm install安装依赖，再尝试npm run build。
• 跳过构建环节的严格校验：如果你的项目是基于create-react-app搭建的，CI环境默认会开启全量严格校验，本地开发未触发的ESLint、TS语法警告会在构建时被判定为错误终止流程，可以临时修改package.json中的build命令为CI=false react-scripts build，跳过严格校验验证是否能正常构建。
• 核对文件路径大小写：Windows/macOS系统默认对文件路径大小写不敏感，而构建环境一般为大小写敏感的Linux系统，若代码中import语句的路径大小写和实际文件路径存在出入，本地开发不会报错但构建会失败，逐一核对所有引入路径的大小写是否完全匹配即可。
• 验证Node版本兼容性：本地Node.js版本和项目兼容的版本不一致也会触发无明确原因的构建报错，可通过nvm切换到项目package.json中指定的Node大版本，重新安装依赖后再尝试构建。

错误提示截图参考：

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