You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

求助:GitHub Pages部署后仅显示空白页面问题排查

GitHub Pages 空白页排查方案
  • 检查浏览器控制台错误:打开站点后按F12进入控制台,查看是否有资源加载失败(404)或JS报错。这是定位空白页最直接的方式,比如资源路径错误会导致样式/脚本无法加载,页面无内容。
  • 验证资源引用路径:确认index.html里的CSS、JS引用是否为相对路径。比如如果你的CSS在css/style.css,引用应该写./css/style.css而非绝对路径/css/style.css(GitHub Pages有时对根路径解析有差异,尤其是自定义域名未配置好时)。
  • 检查GitHub Pages部署状态:进入仓库的Settings > Pages,查看最新的部署记录是否显示“Success”。如果部署失败,页面会停留在旧版本或空白,此时需要查看部署日志里的错误提示。
  • 确认文件编码与语法:检查index.html、CSS、JS文件是否有语法错误(比如HTML标签未闭合、JS语法错误),或文件编码非UTF-8,这会导致浏览器无法正确解析内容。
  • 清除浏览器缓存:有时浏览器会缓存旧的空白页面,按Ctrl+Shift+R强制刷新,或使用无痕模式访问站点。

针对你的仓库,建议优先查看控制台的资源加载情况,大概率是资源引用路径问题导致样式和脚本未加载,进而页面无内容显示。

内容的提问来源于stack exchange,提问作者Vishnuvarthan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.14 22:14:54