遵循模板搭建的网站本地正常，部署GitHub Pages后空白且报404错误求助

• 修正基础路径配置
  你的站点部署在/3DPortfolio/子路径下，本地开发用的是根路径/，这会导致资源引用路径不匹配。根据你用的框架调整配置：

  • Vite项目：在vite.config.js中设置base: '/3DPortfolio/'
  • Create React App：在package.json添加"homepage": "/3DPortfolio/"
  • 静态资源尽量用相对路径（比如./assets/xxx）代替绝对路径（/assets/xxx）

• 确认构建产物已正确上传
  先在本地执行npm run build生成生产环境包（一般是dist或build文件夹），再把这个文件夹推送到仓库。如果用GitHub Actions自动部署，要确保Action配置里包含了npm run build步骤，并且将构建产物部署到gh-pages分支。

• 检查资源路径大小写
  本地Windows系统不区分文件名大小写，但GitHub Pages服务器是Linux环境，严格区分。比如你本地写的/Assets/main.js，仓库里实际是/assets/main.js，就会触发404。逐一核对控制台报错的资源路径和仓库文件的大小写是否一致。

• 定位具体404资源
  打开浏览器控制台，查看具体是哪个资源返回404（比如某JS文件、图片）。对照这个路径去仓库里找对应文件，确认路径是否匹配——比如控制台显示/3DPortfolio/assets/js/app.js 404，就去仓库的构建产物目录里检查是否存在这个文件，或者路径是否写错。

• 核对GitHub Pages部署设置
  进入仓库的Settings -> Pages页面，确认部署分支是存放构建产物的分支（比如gh-pages），并且部署目录选择正确（比如构建产物在分支根目录就选/root，在dist文件夹就选/dist）。

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