部署React应用至GitHub时npm run deploy失败，提示找不到build目录

核心问题分析 #

报错ENOENT: no such file or directory, stat 'C:\Users\USER 2021\Desktop\robotfriends\build'说明npm run build命令并未成功生成build目录，或者生成过程中出现了未捕获的错误。从你提供的日志来看，predeploy阶段仅触发了build命令，但未展示build的具体执行日志，这是关键排查点。

分步排查方案 #

• 手动执行build命令，查看完整日志
  直接在项目根目录执行：

  npm run build
  

  仔细观察输出，确认是否有编译错误（比如语法错误、依赖缺失、资源路径问题）。如果build失败，会直接给出具体错误信息，这是最直接的排查方式。

• 解决路径含空格的问题
  你的项目路径C:\Users\USER 2021\Desktop\robotfriends包含空格，部分Node.js工具在处理带空格的路径时会出现异常。建议将项目移动到无空格的路径下，比如C:\Users\USER2021\Desktop\robotfriends，再重新执行npm run deploy。

• 清理依赖缓存后重建
  依赖缓存或损坏的node_modules可能导致build失败，执行以下步骤：

  1. 删除项目根目录下的node_modules文件夹和package-lock.json文件
  2. 清理npm缓存：

     npm cache clean --force
     

  3. 重新安装依赖：

     npm install
     

  4. 再次执行build：

     npm run build
     

• 调整react-scripts版本
  你使用的react-scripts@5.0.1在部分Windows环境下存在build异常的情况，可以尝试升级到最新稳定版，或降级到4.x版本：

  • 升级：

    npm install react-scripts@latest --save
    

  • 降级：

    npm install react-scripts@4.0.3 --save
    

  安装完成后重新执行npm run deploy。

• 明确指定build目录路径
  如果build目录确实生成，但gh-pages无法识别，可以尝试在deploy命令中使用相对路径：
  修改package.json中的scripts：

  "deploy": "gh-pages -d ./build"
  

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