VS Code 本身不运行 HTML，所谓“运行失败”本质是预览链路断了——不是代码错，而是打开方式错误：双击用 file:// 协议会触发浏览器安全拦截，必须用 Live Server 插件启动 http://127.0.0.1:5500 服务来绕过限制，且需确保工作区已正确打开、文件已保存、端口未冲突。
VS Code 本身不运行 HTML，所谓“运行失败”本质是预览链路断了——不是代码错，而是你没走对打开方式。
点右键没“Open in Browser”或点了没反应
这是最常见假性报错：VS Code 没权限调用系统默认浏览器，或根本没设默认浏览器。
- 右下角状态栏看语言模式，如果是
Plain Text，点击它 → 选HTML - Windows 用户检查系统默认应用：设置 → 应用 → 默认应用 → .html → 设为 Edge 或 Chrome
- Mac 用户在 Finder 中右键 HTML 文件 → “显示简介” → “打开方式”选浏览器 → 点“全部更改”
- 别信“Open in Browser”插件——它只是转发系统调用，底层失效时它也白搭
点“Go Live”后浏览器打不开或报 Unable to connect to localhost
Live Server 插件启动失败，但错误不提示，只静默失败。
- 确认已安装 Ritwick Dey 的原版
Live Server（扩展 ID：ritwickdey.LiveServer） - 必须先在 VS Code 中打开一个
.html文件（不是只打开文件夹），右键才有Open with Live Server - 检查端口冲突：默认
5500被占时它会自动换端口，但有时卡住；手动配liveServer.settings.port到3000或8080 - 别在
launch.json里硬写url: "http://localhost:8080"—— Live Server 启的是http://127.0.0.1:5500，协议+端口必须严格匹配
页面打开但 JS 报 net::ERR_FILE_PROTOCOL 或 fetch 失败
你正用 file:// 协议双击打开，这不是“运行失败”，是浏览器主动拦截。
立即学习“前端免费学习笔记（深入）”；
- 所有现代浏览器都禁用
file://下的fetch、import、XMLHttpRequest加载本地资源 - 绝对不要双击 HTML 文件，也不要依赖“Open in Default Browser”类插件
-
Live Server是唯一解：它走http://协议，绕过全部安全限制 - 相对路径出 404？Live Server 根目录是当前工作区（
${workspaceFolder}），不是文件所在目录；图片路径写成./logo.png或加<base href="./">
右上角 ▶️ 按钮消失或点了报 Code language not supported or defined
这是 Code Runner 插件在瞎指挥，它根本不该管 HTML。
-
Code Runner的executorMap里配"html"是典型误配——HTML 不是可执行语言，没有 runtime - 删掉
settings.json中类似"html": "chrome"这种配置，它只会触发浏览器找不到或路径解析失败 - 如果非要保留 Code Runner，请在
code-runner.ignoreSelection设为true，避免它劫持 HTML 文件 - 真正需要调试 JS？装
Debugger for Edge或Debugger for Chrome，再配launch.json，而不是靠 ▶️ 按钮
最容易被忽略的点：Live Server 启动后，地址栏必须是 http://127.0.0.1:5500/xxx.html 这种格式，任何 file://、localhost（没服务）、index.html（没带路径）都意味着你根本没走对链路。
