Live Server“Go Live”无反应的根本原因是服务未启动成功，常见于根目录缺失index.html、body标签被注释或浏览器缓存未禁用；需确保index.html存在、body未注释、DevTools中禁用缓存，并检查状态栏端口提示。
Live Server 点“Go Live”没反应，状态栏不显示端口
根本原因是服务压根没启动成功，不是热更新失效，而是连服务器都没跑起来。
常见触发点：index.html 缺失、被重命名（如叫 main.html）、或不在当前打开的文件夹根目录下。Live Server 默认只认根目录下的 index.html，不会扫描子目录，也不支持 fallback 文件名。
- 最简解法：在当前工作区根目录新建一个空的
index.html文件（哪怕只写<!DOCTYPE html><html><body></body></html>） - 右键任意 HTML 文件 → 选择
Open with Live Server，可绕过index.html限制，但此时服务根路径变成该文件所在目录，相对路径行为会变 - 检查 VS Code 右下角状态栏是否出现类似
Live Server: 5500的提示，没有就说明没启动，别急着调刷新逻辑
改了 HTML/CSS/JS，浏览器页面不刷新
Live Server 的刷新依赖注入一段 WebSocket 脚本到页面末尾（</body> 前），一旦注入失败，就只剩手动 F5。
-
<body>标签必须存在且**未被注释**——整段<body>...</body>被<!-- ... -->包住，脚本就插不进去 - 避免在
<head>或<body>开头加<script type="module">或带defer的外部脚本，它们可能提前触发 DOM 解析完成，导致注入时机错过 - 确认
liveServer.settings.reload设为true（写进项目级.vscode/settings.json，不是用户设置） - 别和 Vite/Webpack 同时开——两个本地服务共存容易误点旧链接，且 Live Server 不处理模块解析，
import报错时它只会刷新白屏
刷新了但看到的还是旧样式或旧逻辑
这不是 Live Server 的问题，是浏览器缓存资源（CSS/JS）导致的假象。Live Server 只负责 reload 页面，不控制 HTTP 缓存头。
- 开发时打开浏览器 DevTools（F12），在 Network 面板勾选
Disable cache（仅 DevTools 打开时生效） - 给静态资源加查询参数强制更新，比如
<link rel="stylesheet" href="style.css?v=2">，每次改完手动改个数字 - 用无痕模式测试，排除浏览器插件（如广告拦截器、代码高亮工具）干扰
- 别依赖
Reopen with Live Server清缓存——它只是重启服务，不清理浏览器已加载的 JS/CSS
端口冲突或自动打开浏览器烦人
默认端口 5500 和自动唤起浏览器是可配的，不用动插件源码，也不用关防火墙。
- 打开 VS Code 设置（
Ctrl+,），搜live server settings - 修改
liveServer.settings.port为其他值（如3000或8080），避免和npm run dev冲突 - 设
liveServer.settings.AdvanceCustomBrowserCmdLine为空字符串，即可禁用自动打开 - 开启
liveServer.settings.donotVerifyPort，防止端口被占时静默失败（它会自动找下一个可用端口）
Live Server 的热更新本质是整页刷新，不是 HMR；它不维护状态、不解析模块、不处理构建流程。只要页面结构合法、网络通、缓存清、配置对，它就能稳稳跑。最容易被忽略的是 <body> 存在性与浏览器缓存——这两点卡住时，所有配置都白调。
