VSCode 无真正内置浏览器插件，Browser Preview 是基于 Headless Chromium 的第三方嵌入式预览工具；需手动配置浏览器路径，支持 chrome://inspect 调试但不提供完整 DevTools 界面。
先说一个核心事实：VSCode 本身并没有所谓的“内置”浏览器插件。我们常提到的“内置浏览器”功能，实际上是由第三方插件（比如 Browser Preview）实现的。它基于 Headless Chromium 技术，在编辑器内嵌入了一个预览窗口。这意味着它并非你系统里的那个完整浏览器，也不自带全套的开发者工具。不过，它确实精准地解决了两个核心痛点：实现“保存即刷新”的流畅体验，以及提供一个轻量级的调试环境。
Browser Preview 插件启动后打不开页面？检查这三处
遇到预览窗口打不开？别急，无非是几种常见情况：要么报错 Failed to launch browser，要么窗口一片空白，或者状态栏一直显示 Connecting... 却毫无反应。问题通常出在以下三个环节：
- 确认插件身份：首先，得确保你装对了。在扩展商店里搜索
Browser Preview时，要认准作者是auchenberg。别把它和Live Server或Live Preview搞混了。 - 手动指定浏览器路径：这是最关键的一步。插件首次运行时，需要你告诉它本地浏览器的位置。打开命令面板（
Ctrl+Shift+P），输入Browser Preview: Configure Browser Path，然后选择你电脑上 Chrome 或 Edge 可执行文件的完整路径。比如在 macOS 上，路径可能类似/Applications/Google Chrome.app/Contents/MacOS/Google Chrome；而在 Windows 上，则通常是C:\Program Files\Google\Chrome\Application\chrome.exe。 - 注意 Mac 芯片架构：如果你用的是 M1 或 M2 芯片的 Mac，这里有个坑要避开。如果你不小心选择了为 Intel 芯片（x86_64）编译的 Chrome 版本，很可能无法启动。务必选择 Apple Silicon 的原生版本。
Live Server 和 Browser Preview 到底该用哪个？
这俩插件功能有重叠，但定位不同。选择哪一个，完全取决于你的具体场景：Live Server 更适合纯静态页面的快速预览和热更新；而 Browser Preview 则胜在与现代前端构建工具深度集成，以及提供更接近真实浏览器的调试能力。
- Live Server：轻快的文件托管服务。它的本质是一个迷你 HTTP 服务器（默认端口
5500），核心职责就是托管你的文件并在文件保存时自动刷新页面。但它不提供源码调试能力，你无法在里面直接打断点，或者从console.log信息跳回源代码。 - Browser Preview：嵌入式的浏览器内核。它直接启动了一个真实的浏览器实例。这意味着你可以通过访问
chrome://inspect来连接完整的 Chrome DevTools，从而支持debugger语句、断点调试、查看作用域变量等高级操作。 - 鱼与熊掌可兼得：一个聪明的做法是让两者协同工作。先用
Live Server启动一个本地服务器（例如https://localhost:5500），然后配置Browser Preview去加载这个地址。这样既能享受Live Server的快速刷新，又能利用Browser Preview进行深度调试。
launch.json 配置 pwa-chrome 时断点不生效？重点看 webRoot 和 sourceMapPathOverrides
在 VS Code 的调试配置里使用 pwa-chrome 时，断点失灵是高频问题。典型症状是：代码里打了断点，但 VS Code 里显示一个空心圆（表示未绑定），按 F5 启动后程序直接跳过；或者断点只能打在编译后的 bundle.js 上，无法映射回原始的 src/App.tsx 文件。问题的症结，几乎都出在路径映射上。
webRoot必须指对地方：这个参数必须指向你源代码的实际根目录。对于常见的 React 或 Vite 项目，它通常是"${workspaceFolder}/src"，而不是整个工作区文件夹"${workspaceFolder}"。指错了，调试器就找不到你的源文件。sourceMapPathOverrides因工具而异：不同的构建工具，其生成的 Source Map 路径前缀也不同，这里需要正确映射。
— 对于 Vite 项目，通常的规则是："vite:///src/*": "${webRoot}/*"
— 对于 Webpack 项目，则常见为："webpack:///src/*": "${webRoot}/src/*"
— 如果不确定，有个实用的排查方法：先暂时删掉这项配置，然后启动调试，在浏览器 DevTools 的 Sources 面板里，查看左边文件树中你的源码路径前缀是什么（比如是webpack://还是vite://），再据此反推出正确的映射规则。- 确保生成了 Source Map：这是前提条件。务必确认你的构建流程配置了生成 Source Map。在 Vite 项目中，检查
vite.config.js里是否设置了build: { sourcemap: true }；而使用 Create React App 创建的项目默认已开启，通常无需额外配置。
最后，必须警惕一个普遍的误解：Browser Preview 的那个“预览窗口”本身，并不提供完整的 DevTools 界面。如果你想使用断点、查看网络请求或性能分析，必须手动在外部浏览器中打开 chrome://inspect 页面，然后连接对应的调试目标。这并非插件的缺陷，而是其设计如此。所以，别指望在预览窗口里右键就能呼出 Elements 面板——它本来就不是干这个的。
