Live Server 是唯一靠谱的本地预览方案,它通过 http://127.0.0.1:5500 启动真实 HTTP 服务,规避 file:// 协议对 fetch、import、相对路径资源的拦截,复现线上环境;需安装 ritwickdey.LiveServer 插件,以文件夹方式打开项目,右键 HTML 文件选择“Open with Live Server”,确保状态栏显示 Port: 5500。

直接双击打开或右键“在浏览器中打开”index.html,99% 的情况会失败——不是你代码写错了,是浏览器用 file:// 协议加载时,fetch、import、相对路径 JSON/CSS/JS 全部被拦截。
为什么 Live Server 是唯一靠谱的本地预览方案
它启动一个真实的 http://127.0.0.1:5500 本地 HTTP 服务,让浏览器按 Web 标准加载资源,完全复现线上环境行为。
- 必须安装 Ritwick Dey 原版插件(扩展 ID:
ritwickdey.LiveServer),别选同名但作者不明的“精简版” - 必须用 File → Open Folder 打开整个项目文件夹,单独拖一个
.html文件进来,插件不会激活 - 右键 HTML 文件 →
Open with Live Server(不是“Preview”或“Run”);状态栏出现Port: 5500才算真正启动 - 端口被占时,点状态栏端口号 →
Change Port换成5501等即可
VSCode 里改了代码,浏览器没刷新?先查这三处
Live Server 默认保存即刷新,但以下情况会导致静默失效:
- 浏览器地址栏显示的是
file:///开头——说明根本没走 Live Server,关掉旧标签,重新右键启动 - CSS 或 JS 修改后没生效——Live Server 默认加了
Cache-Control: max-age=3600,开发者工具 Network 面板勾选Disable cache,或手动Ctrl+F5强刷 - 同时开了 Vite/Webpack 等构建工具——端口冲突 + 热更机制打架,必然白屏或 404,关掉其他服务再试
不用插件,纯前端 iframe 实现实时预览只适合静态片段
用 iframe.srcdoc 动态注入 HTML 字符串,能快速看结构和样式,但有硬限制:
-
srcdoc不支持外部资源:和<script src></script>会被忽略 - 内联
<script></script>受 CSP 限制,部分浏览器会静默屏蔽,且无法调试(console.log不出现在主页面开发者工具中) - 示例核心逻辑:
previewFrame.srcdoc = html.replace('', `${css}`).replace('', `${js}`);
真正要调试 fetch、模块导入、localStorage、Service Worker,就别绕开 Live Server——它不是“方便选项”,而是本地开发的协议底线。端口、路径、工作区打开方式,三者错一个,就退回到 file:// 的报错地狱。











