如何修复Vercel/Github部署前端项目时出现的404错误？

• 部署路由配置缺失
  纯静态单页应用在Vercel上直接访问非根路径时，默认会返回404。你需要在项目根目录添加vercel.json文件，配置路由重写：

  {
    "rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]
  }
  

  同时检查Vercel项目设置里的构建配置：Build Command留空（静态项目无需构建），Output Directory设为你的静态文件所在目录（比如./，如果所有文件都在根目录）。

• 本地代码推送不完整
  换了新Mac后，可能Git配置或操作有误，导致推送到Github的代码不全：

  • 用git remote -v确认本地仓库已正确关联远程Github仓库
  • 检查.gitignore文件，有没有误排除index.html、CSS/JS这类核心文件
  • 执行git diff origin/main对比本地和远程仓库的代码，确认所有必要文件都已推送

• Vercel缓存残留
  重建仓库后Vercel可能还留存旧的缓存数据，导致部署异常：
  到Vercel项目的Deployments页面，手动触发重新部署，记得勾选「Clear build cache」选项，强制清理缓存后重新构建。

• DNS或本地缓存问题
  如果用了自定义域名，本地DNS缓存可能指向旧的失效地址。试试用无痕模式访问，或者清除本地DNS缓存后再测试。

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