Live Server是VSCode中最稳的HTML/CSS/JS实时预览方案,但需满足三个前提:以文件夹形式打开工作区、HTML文件已保存且扩展名为.html、浏览器访问必须使用http://而非file://协议。

Live Server 是目前 VSCode 里最稳的 HTML/CSS/JS 实时预览方案,但“点一下就动”只是表象;真要它可靠工作,必须满足三个前提:工作区是文件夹、HTML 已保存、浏览器走的是 http:// 协议而非 file://。
Live Server 点“Go Live”没反应?先确认工作区和文件状态
它不支持单个 HTML 文件拖进 VSCode 就启动。根本原因不是插件坏了,而是服务压根没被触发。
- 必须通过 文件 → 打开文件夹 加载整个项目,资源管理器里能看到
index.html和css/子目录 -
index.html必须已保存(不能是未命名的临时标签页),扩展名得是.html(.htm或.txt不认) - 右下角状态栏语言模式要是
HTML,不是Plain Text;点一下可切换 - 右键编辑器里的
index.html标签页 → 选Open with Live Server,比点状态栏Go Live更可靠
页面开了但 CSS/JS 没更新?90% 是浏览器缓存或路径错
Live Server 支持 CSS 热重载,但只负责发通知;浏览器愿不愿意重新拉取,得你来管。
- 保存
style.css后,VSCode 右上角应弹出Reloading CSS…提示——没有说明 Live Server 没监听到改动 - Chrome/Firefox 开发者工具 →
Network标签 → 勾选Disable cache(仅 DevTools 打开时生效) -
<link rel="stylesheet" href="css/style.css">对应的磁盘路径必须是./css/style.css,不是./assets/css/style.css - 避免多层
@import:嵌套@import的热更新在 Live Server 中不可靠
想在手机上看?改 host、查 IP、过防火墙三步缺一不可
默认 localhost 绑定只允许本机访问,手机连同一 Wi-Fi 也打不开,不是网络问题,是服务没对外暴露。
- VSCode 设置里搜
liveServer.settings.host,值改成0.0.0.0(不是localhost,也不是留空) -
liveServer.settings.port设为固定值,比如5500,别用0(自动选端口会导致手机书签失效) - 用电脑局域网 IP 访问,比如
http://192.168.1.105:5500;Windows 运行ipconfig,macOS 运行ifconfig | grep "inet " | grep -v 127.0.0.1 - Windows Defender 防火墙或 macOS 防火墙需放行该端口;部分路由器开启「AP 隔离」也会拦住,需关闭
为什么改了代码页面还是旧的?刷新逻辑有隐藏规则
Live Server 默认只监听 .html、.htm、.xhtml、.php 文件变更并触发整页刷新;.css 和 .js 的改动默认不刷新页面,只尝试热重载(且仅限部分场景)。
- 改完
script.js没反应?手动按Ctrl+Shift+R(Win/Linux)或Cmd+Shift+R(Mac)硬刷新 - 若用了
<base href="/>,所有相对路径都按这个 base 解析,极易导致 404;调试时建议先删掉 - Live Server 不处理构建流程;如果项目用了 Vite/Webpack,别同时开它——端口冲突、刷新逻辑打架,大概率白屏
- 某些安全插件(如 uBlock Origin)会静默拦截
localhost流量,可临时禁用验证
最常被忽略的一点:Live Server 启动后,浏览器地址栏必须是 http://127.0.0.1:5500/xxx.html 这类格式。只要看到 file:/// 开头,就说明你根本没用上它——所有 fetch、ES module、相对路径加载都会在暗处失败,而你可能还觉得“页面能显示,应该没问题”。


















