React作品集项目部署GitHub Pages后显示空白页求助

先处理「ENOENT: no such file or directory, stat '/Users/vascosousa/Desktop/3d_portfolio/build'」错误 #

• 确认npm run build执行结果：
  手动进入你的项目根目录（应为personal-portfolio，而非报错里的3d_portfolio），查看是否生成了build文件夹。如果没有，检查npm run build的输出日志，排查编译错误（比如语法问题、依赖缺失），修复后重新执行build。
• 核对终端工作目录：
  报错路径指向3d_portfolio，但你的项目仓库是personal-portfolio，说明你可能在错误的文件夹下执行了npm run deploy。切换到personal-portfolio根目录后再重新运行命令。
• 验证package.json配置：
  1. 确认scripts中的deploy脚本是否正确：应为"deploy": "gh-pages -d build"，确保-d后跟随的是build生成的文件夹名称（默认是build，若自定义为dist等需对应修改）。
  2. 检查是否添加homepage字段：在package.json根节点添加"homepage": "https://vasco-alex-sousa.github.io/personal-portfolio"，这个字段会让react-scripts正确生成资源路径，避免后续页面空白。

再解决部署后页面空白问题 #

• 调整路由模式：如果使用了React Router，将BrowserRouter替换为HashRouter——GitHub Pages不支持前端路由的history模式，会导致页面刷新或直接访问子路由时出现空白/404。
• 排查资源加载情况：部署后打开浏览器控制台，查看是否有资源加载失败（404）。若存在此类问题，说明homepage字段设置错误，或build时资源路径生成异常，需重新检查配置后再次执行build、deploy。
• 确认gh-pages分支内容：部署成功后，GitHub仓库会自动生成gh-pages分支，确保该分支下的文件是build文件夹内的产物，而非项目源码。

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