求助: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
相关产品推荐
相关产品推荐

