vscode本身不支持真正的html实时预览,必须用live server插件启动本地http服务(如http://127.0.0.1:5500)绕过file://协议限制;双击或右键“在浏览器中打开”因浏览器安全策略会导致fetch、import、相对路径等全部报错。

VSCode 本身不提供真正的 HTML 实时预览能力,双击打开或右键“在浏览器中打开”走的是 file:// 协议,只要页面里有 fetch()、import、相对路径的 JSON/CSS/JS,基本就报错——这不是你代码问题,是浏览器策略限制。
Live Server 是唯一能绕过 file:// 限制的方案
它起一个真实的本地 HTTP 服务(比如 http://127.0.0.1:5500),让浏览器按 Web 标准加载资源。必须装 Ritwick Dey 原版插件(扩展 ID:ritwickdey.LiveServer),别选同名但作者不明的“精简版”。
- 安装后必须用“打开文件夹”方式加载项目,单独拖一个
.html文件进来,插件根本不会激活 - 右键 HTML 文件 →
Open with Live Server,或点状态栏Go Live按钮(仅当当前编辑器已打开并保存了.html文件时才出现) - 默认端口
5500被占时,点状态栏右下角的端口号 →Change Port换个数字即可 - 如果项目有多个 HTML(如
admin.html),Live Server 不会自动识别入口,每次得手动右键对应文件再开
Live Preview(Microsoft 官方)适合纯静态快速看效果
它不启动 HTTP 服务,而是直接解析 HTML/CSS/Markdown 并渲染到 VSCode 内置面板,不解决跨域或模块加载问题,但胜在轻量、无需配置。
- 装
ms-vscode.live-preview(注意是preview,不是server) - 快捷键
Ctrl+Shift+P→ 输入Live Preview: Show Preview启动,或点编辑器右上角眼睛图标 - 只对已保存的
.html、.htm、.css、.md生效;自定义后缀(如.svelte)不支持 - 修改后约 300ms 自动刷新,但不监听软链接目录、WSL 或网络盘路径下的变更
为什么 Open in Default Browser 总是出问题
VSCode 内置的这个命令只是模拟双击,底层仍是 file:// 协议。你会看到页面渲染出来,但以下情况必然失败:
-
fetch('./data.json')→ 控制台报Not allowed to load local resource -
<script type="module"></script>→ 报Failed to load module script - 路径
../config/data.json必然 404,而./img/logo.png可能显示(取决于浏览器宽松程度) -
localStorage和Service Worker在file://下本就不被支持
静态资源 404 或 CSS/JS 不生效的真实原因
Live Server 启动后,所有相对路径都以**HTML 文件所在目录为基准**,不是工作区根目录。比如 src/index.html 里写 <link rel="stylesheet" href="../css/main.css">,浏览器就会请求 http://127.0.0.1:5500/css/main.css —— 你得确保磁盘上真有这个路径。
- 避免在 HTML 中加
<base href="/>%EF%BC%8C%E5%AE%83%E4%BC%9A%E5%BC%BA%E8%A1%8C%E6%94%B9%E5%86%99%E6%89%80%E6%9C%89%E7%9B%B8%E5%AF%B9%E8%B7%AF%E5%BE%84%EF%BC%8C%E6%9E%81%E6%98%93%E5%BC%95%E5%8F%91%20404 %0A - CSS/JS%20%E4%BF%AE%E6%94%B9%E5%90%8E%E4%B8%8D%E8%87%AA%E5%8A%A8%E5%88%B7%E6%96%B0%EF%BC%9FLive%20Server%20%E9%BB%98%E8%AE%A4%E5%8F%AA%E7%9B%91%E5%90%AC%20
.html%20%E7%B1%BB%E6%96%87%E4%BB%B6%E5%8F%98%E6%9B%B4%EF%BC%8C.css%20%E5%92%8C%20.js%20%E6%94%B9%E4%BA%86%E4%B8%8D%E4%BC%9A%E8%A7%A6%E5%8F%91%E9%87%8D%E8%BD%BD%EF%BC%88%E9%99%A4%E9%9D%9E%E4%BD%A0%E9%A2%9D%E5%A4%96%E9%85%8D%E4%BA%86%E7%83%AD%E6%9B%B4%E6%96%B0%E5%B7%A5%E5%85%B7%EF%BC%89 %0A - %E6%B5%8F%E8%A7%88%E5%99%A8%E5%BC%BA%E7%BC%93%E5%AD%98%E4%BC%9A%E5%AF%BC%E8%87%B4%E4%BD%A0%E6%94%B9%E4%BA%86%20
style.css%20%E5%8D%B4%E7%9C%8B%E4%B8%8D%E5%88%B0%E5%8F%98%E5%8C%96%EF%BC%9A%E5%BC%80%E5%8F%91%E6%97%B6%E7%94%A8%20Ctrl+Shift+R%20%E7%A1%AC%E5%88%B7%E6%96%B0%EF%BC%8C%E6%88%96%E5%9C%A8%E8%AE%BE%E7%BD%AE%E9%87%8C%E5%8A%A0%20liveServer.settings.AdvanceCustomBrowserCmdLine%20%E5%8F%82%E6%95%B0%E7%A6%81%E7%94%A8%E7%BC%93%E5%AD%98 %0A
%E7%9C%9F%E6%AD%A3%E5%AE%B9%E6%98%93%E8%A2%AB%E5%BF%BD%E7%95%A5%E7%9A%84%E7%82%B9%EF%BC%9ALive%20Server%20%E7%9A%84%E6%9C%8D%E5%8A%A1%E8%8C%83%E5%9B%B4%E6%98%AF%E6%95%B4%E4%B8%AA%E5%B7%A5%E4%BD%9C%E5%8C%BA%E6%A0%B9%E7%9B%AE%E5%BD%95%EF%BC%8C%E4%B8%8D%E6%98%AF%E5%8D%95%E4%B8%AA%E6%96%87%E4%BB%B6%EF%BC%9B%E8%80%8C%20Live%20Preview%20%E7%9A%84%E7%83%AD%E6%9B%B4%E6%96%B0%E4%BE%9D%E8%B5%96%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F%E4%BA%8B%E4%BB%B6%EF%BC%8C%E9%81%87%E5%88%B0%E7%AC%A6%E5%8F%B7%E9%93%BE%E6%8E%A5%E3%80%81WSL%E3%80%81%E8%BF%9C%E7%A8%8B%20SSH%20%E5%B0%B1%E5%A4%A7%E6%A6%82%E7%8E%87%E5%A4%B1%E6%95%88%E3%80%82%E5%88%AB%E5%9C%A8%E6%B2%A1%E7%A1%AE%E8%AE%A4%E5%8D%8F%E8%AE%AE%E5%92%8C%E8%B7%AF%E5%BE%84%E5%9F%BA%E5%87%86%E7%9A%84%E6%83%85%E5%86%B5%E4%B8%8B%E8%B0%83%20bug%E3%80%82
%0A">前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











