蓝象 · 跑不通 · 部署排错
本地正常，上线白屏：先看资源路径
一次子目录部署留下的排查记录：从 /assets 的 404，找到 Vite 的 base 配置。
01 / 先确认浏览器拿到了什么
这个网站部署在 /happy-graduation/ 下时，出现过页面空白的问题。HTML 已经返回，页面里的脚本却请求了域名根目录下的 /assets/，而文件实际位于 /happy-graduation/assets/。脚本请求返回 404，应用自然无法启动。
遇到类似情况，先打开浏览器开发者工具的 Network 面板，刷新页面，找到失败的 JS、CSS 请求。对比请求地址与服务器上文件的位置；Console 里的加载错误也能帮你缩小范围。
02 / 让构建结果知道部署位置
这个项目在 Vite 配置中将 base 设为 "./"，使构建产物里的资源地址相对于当前页面解析。这样从 /happy-graduation/ 打开首页时，资源会从该目录下加载。修改源码配置后，需要重新执行构建，之前的 dist 不会自动改变。
如果部署目录始终固定，也可以明确配置 base: "/happy-graduation/"。相对路径适合这个静态站的部署方式；使用前端路由或其他目录结构时，还需要一并确认路由基路径和服务器回退规则。
03 / 用线上请求验证修复
重新构建后，将新的 dist 内容完整上传到对应目录，保留文件之间的层级关系。打开线上地址并强制刷新，确认 JS、CSS 请求返回成功，响应内容也确实是脚本和样式，而不是服务器回退的 HTML 页面。
最后再检查图片、图标和下载链接。构建工具会处理它识别到的资源引用，手写的根路径仍需单独确认。页面能打开之后，把部署目录和构建命令记进说明，下次就少猜一步。