HTML白屏主因是文件未加载或解析失败：先查Network面板状态码是否404/403，再验Content-Type是否text/html，接着用W3C验证HTML语法，然后排查script阻塞报错，最后检查CSS/字体导致的伪空白。
HTML代码不渲染，页面完全空白
浏览器打开后白屏，连 <body> 都没出来，大概率是 HTML 文件根本没被正确加载或解析。不是 JS 报错导致的“内容消失”，而是整个文档树都没建起来。
检查顺序按优先级来：
- 打开浏览器开发者工具（F12），看 Network 面板里
index.html（或你访问的 HTML 文件）状态码是不是404或403—— 路径错、大小写错、服务器没配 MIME 类型都可能卡在这步 - 右键页面空白处选“查看页面源代码”，如果看到的是原始 HTML 文本（比如有
<html><head>），说明文件加载了但没被当成 HTML 解析；此时重点查响应头里的Content-Type是否为text/html，不是就强制改（如用 Express 加res.set('Content-Type', 'text/html')） - 如果源代码里啥都看不到（一片空），说明服务器返回了空响应或重定向到了一个不存在的地址，检查服务器日志或
curl -v http://localhost:3000/index.html看真实响应
HTML标签写错导致解析中断
浏览器遇到严重语法错误（比如未闭合的 <script>、嵌套错乱的 <table>）会尝试容错，但某些情况下会直接放弃后续解析，后面所有内容都不显示。
典型表现：页面只显示前半部分，或者从某一行开始彻底空白。这时候别急着查 JS，先看 HTML 结构本身：
立即学习“前端免费学习笔记（深入）”；
- 用 W3C Markup Validation Service 粘贴源码验证，重点关注
Unclosed element、Stray end tag类报错 - 常见坑：
<script src="app.js"></script>里面又写了内联 JS（不允许）；<pre>里用了未转义的<导致标签被误解析；<textarea>内容含</textarea>字符串却没做转义 - 临时排查法：把 HTML 从底部往上删，每次删一段刷新，直到页面恢复，就能定位出问题区块
script 标签阻塞 + 执行报错导致白屏
如果 HTML 结构没问题，但 <script> 放在 <head> 或靠前位置，且内部有同步执行的致命错误（比如调用了一个不存在的函数），浏览器会停在那一步，后续 DOM 渲染中断。
这不是“JS 错了所以功能不工作”，而是“JS 错了所以页面压根不画”：
- 打开开发者工具的 Console 面板，看有没有红色报错，尤其是
ReferenceError、SyntaxError这类早期错误 - 检查
<script>是否加了defer或async属性 —— 如果没加，又依赖了尚未定义的变量或 DOM 元素，就容易出问题 - 服务端渲染（SSR）场景下更危险：Node.js 环境里用了浏览器专属 API（如
window、document），导致首屏直出失败，返回空字符串
CSS 或字体加载失败引发的“伪空白”
页面其实渲染出来了，但文字颜色和背景色一致、字体加载失败导致文本不可见、或者 visibility: hidden / opacity: 0 被全局应用，看起来像白屏。
这类问题容易误判为 HTML 故障：
- 按 Ctrl+A 全选页面，看能不能选中文字；或者右键“检查元素”，看
<body>下是否有 DOM 节点存在 - 在 Elements 面板里逐个禁用
style标签或内联样式，观察是否突然出现内容 - Network 面板过滤
font，看.woff2是否返回404；有些字体加载失败会触发font-display: swap的 fallback 行为，但若设成block且超时，可能长时间空白
最麻烦的情况是多个因素叠加：HTML 路径错 + 后端模板引擎静默失败 + 前端路由又开了 history 模式 —— 此时白屏但控制台无报错，得一层层剥开服务端、网络、浏览器三端的日志和响应体。别跳过 curl -v 和 Network 面板的原始响应头。
