Bolt 预览区突然白屏、灰屏或者整个项目卡住时，很多人第一反应是“AI 又把代码改炸了”。但按照 Bolt 自己的故障排查文档，这类问题经常不完全是代码逻辑错，而是浏览器里的 WebContainer 环境顶不住了，比如本机内存紧张、扩展拦截、网络异常，或者上下文太乱让项目本身越来越重。
Bolt 的运行环境很依赖你本机浏览器资源。项目越大、依赖越多、浏览器标签越多，越容易把 WebContainer 压到不稳定。于是你看到的现象就会像代码坏掉：预览不出现、命令不响应、页面卡在加载中。
实用排查顺序建议这样走：
1. 先刷新一次预览，再让 Bolt 直接修“preview is not showing”。
2. 如果还不行，清一次上下文，Bolt 官方也建议在卡住时先用 clear context 的思路减负。
3. 关闭高占用标签页、重启浏览器，必要时直接重启电脑释放内存。
4. 暂时停掉广告拦截、脚本增强类扩展，再试一次。
5. 如果项目依赖太杂，考虑在终端做一次清理，或者把无关文件排进 .bolt/ignore。
别小看浏览器扩展和本机资源，这两类问题在 WebContainer 场景里比传统本地 IDE 更常见。你在本地 dev server 能跑，不代表浏览器里那套隔离环境也一定扛得住。
还有一种情况是网络层。Bolt 官方也提到，某些 Wi-Fi、路由器或公司网络设置会让预览链路出问题。如果切热点后突然恢复，那就别再死盯代码文件本身了，问题更可能在网络或浏览器环境。
如果你排完这些外层因素后仍然白屏，再回头看代码才更有效。否则很容易陷入“每次白屏就让 AI 重构一遍”，最后项目越修越大，反而更容易把 WebContainer 压垮。
所以 Bolt 预览白屏，并不总是代码写坏。很多时候，先给运行环境减压，比继续追着代码改更能解决问题。
