live server 是专为纯静态 html/js/css 调试设计的轻量工具,需通过右键“open with live server”启动、确保地址为 http://127.0.0.1:5500/、避免 file:// 协议,并注意缓存、端口及 https 限制。

Live Server 是唯一能真正让 HTML 文件具备“网页级交互能力”的插件,其他插件最多算辅助工具。
Live Server 启动后页面不自动刷新?检查这三处
常见现象是改完 index.html 或 style.css,浏览器没反应,得手动按 F5。
- 确认右键菜单里选的是「Open with Live Server」,不是「Open in Default Browser」——后者只是静态打开,完全不走 Live Server 流程
- 检查 VS Code 右下角状态栏是否显示「Live Server on http://127.0.0.1:5500」;没显示说明根本没启动,可能被防火墙或代理拦截
- 浏览器地址栏必须是
http://127.0.0.1:5500/xxx.html这类本地地址,而不是file:///开头的路径——后者绕过了服务器,自然不会监听文件变更
修改 JS 逻辑后仍看到旧行为?别忽略缓存和 script 标签
Live Server 默认不强制禁用浏览器缓存,JS 更新常被卡在缓存里,尤其开发时反复改 main.js 却看不到效果。
- 在
<script></script>标签里加type="module"或defer属性,能避免执行时机错乱 - 启动 Live Server 时按住
Ctrl(Windows/Linux)或Cmd(Mac)再点击「Open with Live Server」,会强制开启无缓存模式(即带上?_v=时间戳查询参数) - 如果用了 Webpack/Vite 等构建工具,Live Server 不适用——它只适合纯静态 HTML + JS + CSS 的轻量调试场景
想让 Live Server 支持 HTTPS 或自定义端口?直接改 settings.json
默认 5500 端口可能被占用,或者你正在对接需要 HTTPS 的第三方服务(比如某些支付 SDK),这时就得手动干预。
- 打开 VS Code 设置(
Ctrl+,),搜索「Live Server Config」,点击「Edit in settings.json」 - 添加以下配置项:
{ "liveServer.settings.AdvanceCustomBrowserUrl": true, "liveServer.settings.port": 8080, "liveServer.settings.CustomBrowserUrl": "https://localhost:8080" } - 注意:
CustomBrowserUrl不会真的启用 HTTPS,只是把地址改成 https 前缀——真要用 HTTPS,得配合本地证书或反向代理,Live Server 本身不提供 TLS 支持
Live Server 的边界很清晰:它不处理构建、不编译、不代理 API 请求。一旦项目引入了 import 语法、ES Modules 或需要跨域调用后端,就得换 Vite 或 Webpack dev server——别硬扛。











