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