live server 点“go live”没反应主因是根目录缺 index.html；热更新失效多因 body 缺失或被注释、浏览器缓存；端口和自动打开浏览器可通过设置调整；调试应先查状态栏与控制台报错。
Live Server 插件装了但点“Go Live”没反应
常见原因是工作区根目录下没有 index.html，Live Server 默认只识别这个入口文件。它不会自动扫描子目录或尝试其他 HTML 文件名。
实操建议：
- 确保当前打开的文件夹里有
index.html（哪怕只是空文件） - 如果项目用的是
main.html或app.html，直接重命名为index.html最省事 - 右键点击任意 HTML 文件 → 选择
Open with Live Server，也能绕过入口限制（但热更新仍依赖服务器启动路径） - 检查 VS Code 右下角状态栏是否显示
Live Server: 5500，没显示说明根本没启动成功
页面改了但浏览器不刷新（热更新失效）
Live Server 的热更新本质是注入一个 WebSocket 客户端脚本，靠它监听文件变化并触发 reload。一旦这个脚本没加载进去，就只剩手动刷新。
实操建议：
- 确认 HTML 文件中
标签存在且未被注释——Live Server 会把脚本插入到前，如果整个被注释或缺失，注入失败 - 避免在 HTML 中使用
<script src="..."></script>加载外部 JS 时加defer或type="module"，它们可能干扰注入时机（不是必现，但偶发） - 如果用了构建工具（如 Vite、Webpack），别混用 Live Server——它只适合纯静态 HTML/CSS/JS 原生开发，不处理打包、模块解析或 HMR
想改端口或禁用浏览器自动打开
Live Server 默认用 5500 端口、启动时自动唤起浏览器。这两个行为都能通过 VS Code 设置调整，不需要改插件源码。
实操建议：
- 打开 VS Code 设置（
Ctrl+,或Cmd+,），搜索live server settings - 修改
liveServer.settings.port为想要的数字（比如3000） - 关闭
liveServer.settings.donotVerifyPort可防止端口被占用时报错后静默失败 - 把
liveServer.settings.AdvanceCustomBrowserCmdLine设为空字符串，就能禁用自动打开浏览器
为什么改了 CSS/JS 文件，浏览器里还是旧效果？
不是 Live Server 失效，大概率是浏览器缓存了资源。它只负责通知浏览器 reload 页面，不控制 HTTP 缓存策略。
实操建议：
- 开发时在浏览器开发者工具（F12）的 Network 面板勾选
Disable cache（仅 DevTools 开着时生效） - 给 CSS/JS 引入加版本参数，比如
<link rel="stylesheet" href="style.css?v=1.0.1">，每次改完手动加个新值 - Live Server 本身不支持强制 bust cache，所以别指望右键“Reopen with Live Server”能清掉旧资源——得关掉服务再重开，或清浏览器缓存
Live Server 的热更新逻辑非常轻量，也正因如此，它对 HTML 结构、浏览器缓存、文件命名都挺敏感。稍微偏离“标准静态页”路径，就容易卡在某个环节不动。调试时优先看右下角状态栏和浏览器控制台有没有报 WebSocket connection failed 这类错误，比反复重启插件更有效。
