VS Code没有真正内置浏览器，Browser Preview插件仅嵌入受限的Headless Chromium实例，不支持file://协议、DevTools调试及fetch/ES模块等HTTP依赖功能，仅适合静态页面预览；开发应使用Live Server等HTTP服务方案。
VS Code 没有真正意义上的“内置浏览器”，Browser Preview 插件只是在编辑器内嵌了一个受限的 Headless Chromium 实例，它不等于 Chrome、Edge 或系统浏览器，也不能替代 DevTools 调试能力——你看到的只是预览窗口，不是可调试的运行环境。
Browser Preview 为什么打不开本地 HTML 文件
Browser Preview 默认禁用 file:// 协议，这是 Chromium 的安全策略，不是插件 Bug。它只接受 http:// 或 https:// 地址，所以直接右键“Preview in Browser”对未启动服务的 HTML 文件无效。
- 打开一个本地 HTML 文件 → 点击命令面板（
Ctrl+Shift+P）→ 输入Browser Preview: Preview File→ 仍报错或空白？大概率是路径没走 HTTP - 它不会自动起服务，也不会帮你把
file:///path/to/index.html转成http://127.0.0.1:5500/index.html - 若硬要加载本地文件，得手动配置插件的
browserPreview.browserPath指向 Chrome/Edge 可执行文件，并启用browserPreview.allowFileProtocol（但部分功能如fetch、模块导入仍会失败）
Browser Preview 能做什么、不能做什么
它适合快速查看静态页面结构、响应式布局或文档类 HTML，但不适合开发调试。
- ✅ 支持前进/后退、刷新、地址栏输入 URL（如
https://developer.mozilla.org） - ✅ 可配合
chrome://inspect查看页面进程（需手动配置browserPreview.chromeDebugPort） - ❌ 不提供控制台（Console）、网络（Network）或元素（Elements）面板 —— 这些必须切到外部 Chrome DevTools
- ❌ 不支持 Service Worker、
import.meta.url、fetch('./data.json')等依赖完整 HTTP 上下文的功能 - ❌ 无法调试断点、监听事件、修改样式实时生效（WebView 沙箱限制）
替代方案：比 Browser Preview 更实用的三类做法
别卡在“怎么让 Browser Preview 工作”，先确认你要解决的是什么问题：
- 想边写边看效果 → 用
Live Server插件，右键 HTML 文件选Open with Live Server，自动起http://127.0.0.1:5500/并热重载 - 不想装插件 → 终端跑
python3 -m http.server 8000或http-server -p 8000，然后手动访问http://localhost:8000/index.html - 真要在编辑器里开浏览器查文档/搜 API → 改用
EmbeddedBrowser插件，它通过代理绕过 iframe 安全限制，能正常加载多数网站，且支持历史和恢复会话
最常被忽略的一点：所有依赖现代 Web API 的页面，都必须走 HTTP 协议。Browser Preview 的“内置”只是视觉上的，底层仍是隔离沙箱 —— 它解决不了跨域、模块加载、调试入口这些事。该起服务就起服务，别指望一个预览窗口扛起整个开发流。
