browser preview插件安装后没反应？先检查三件事：系统是否已安装chrome（非chromium兼容版）、vs code是否重启、settings.json中是否误禁用"browser-preview.enabled": false。
Browser Preview 插件安装后没反应？检查这三件事
插件装完点不动、侧边栏没按钮、右下角没 Browser Preview 图标——大概率不是插件坏了，而是没满足运行前提。
- 确保系统已安装 Chrome（非 Chromium 兼容版）：插件底层依赖本地 Chrome 可执行文件，仅靠 Edge 或 Firefox 无法启动；
- VS Code 需重启一次：部分版本安装后不自动激活，必须手动重启编辑器；
- 确认没被工作区设置覆盖：打开
settings.json检查是否误写了"browser-preview.enabled": false这类禁用项。
Open in Browser 和 Browser Preview 到底该选哪个？
二者定位完全不同：Open in Browser 是“甩锅式预览”——把当前 HTML 文件丢给外部浏览器打开；Browser Preview 是“嵌入式调试环境”——在 VS Code 内部跑一个真实 Chromium 实例，支持 DevTools、网络请求拦截、断点调试。
- 静态 HTML 快速查看 → 用
Open in Browser，右键菜单直达，轻量无依赖； - React/Vue 项目热更新调试、跨域接口测试、样式微调 → 必须用
Browser Preview，它能加载http://localhost:3000并保持 WebSocket 连接； - 别混用：同时启用两个插件时，
Open in Browser的快捷键Alt+Shift+O可能被Browser Preview的命令覆盖，建议禁用前者避免冲突。
Browser Preview 启动就报错 “Failed to launch browser”
错误本质是找不到 Chrome 可执行路径，尤其常见于 macOS / Linux 或自定义安装 Chrome 的 Windows 用户。
- 先查 Chrome 是否真在默认路径：Windows 是
C:\Program Files\Google\Chrome\Application\chrome.exe，macOS 是/Applications/Google Chrome.app/Contents/MacOS/Google Chrome； - 手动指定路径：在 VS Code 设置里搜
browser-preview.chromeExecutable，填入你本地 Chrome 的绝对路径； - Linux 用户注意权限：如果用 Snap 安装的 Chrome，路径可能是
/snap/bin/chromium，但Browser Preview不支持 Snap 包，得换 Deb 版或手动下载 Chrome 二进制。
为什么改了 browser-preview.startUrl 还是打开空白页？
这个配置只控制首次启动时加载的 URL，不负责页面刷新逻辑。如果你正在开发本地服务，但预览窗口一直显示 about:blank，问题往往出在服务未就绪或 CORS 阻断。
- 确认服务已启动：在终端执行
curl -I http://localhost:3000，返回200 OK才算有效； - 检查响应头：某些框架（如 Vite）默认加了
X-Frame-Options: deny，会阻止 iframe 嵌入，需在开发服务器配置中显式关闭； - HTTPS 场景要额外设
browser-preview.ignoreHttpsErrors为true，否则自签名证书直接拒绝加载。
