Live Server需在VSCode工作区根目录下打开HTML文件才能生效,依赖HTTP路径而非文件系统路径,端口冲突时可手动修改,默认不支持子目录多入口。

Live Server 扩展在 VSCode 里不是“启动就能预览”,它依赖当前工作区的文件结构和 HTTP 路径规则;直接双击 HTML 文件或用系统默认浏览器打开,Live Server 完全不生效。
为什么点“Go Live”没反应或打不开页面
常见原因是没在正确的上下文中触发:Live Server 只响应工作区根目录下的 HTML 文件,且要求当前打开的文件是该 HTML(不能只是文件夹里有、但编辑器里没打开它)。
- 确保你已通过
File > Open Folder...打开一个文件夹作为工作区,而不是只打开单个 HTML 文件 - 在编辑器中真正打开那个 HTML 文件(比如
index.html),再右键 →Open with Live Server - 如果项目有
src/或public/目录,把index.html放在根目录下,否则 Live Server 默认不进子目录找入口 - 检查右下角状态栏是否出现
Go Live按钮——没出现说明扩展未识别到可服务的 HTML
如何让 Live Server 正确加载 CSS/JS 而不报 404
Live Server 启动的是一个本地 HTTP 服务器(http://127.0.0.1:5500/),所有资源路径必须按服务器根目录解析,不能依赖文件系统相对路径。
- 避免使用
file:///方式打开 HTML,这会导致浏览器禁用跨域请求、CSS/JS 加载失败 -
是对的——前提是style.css和 HTML 在同一级目录 - 如果 CSS 在
css/style.css,路径必须写成href="css/style.css",不能写../css/style.css(除非 HTML 不在根目录) - 图片等静态资源同理:路径以服务器根为基准,不是以当前 HTML 文件位置为基准
端口被占用或想换端口怎么办
Live Server 默认用 5500,但可能被其他程序(如另一个 Live Server 实例、Python 的 SimpleHTTPServer)占住。
- 点击右下角
Go Live按钮旁的小箭头 →Change Port,输入新端口号(如8080) - 永久修改:打开 VSCode 设置(
Ctrl+,),搜索liveServer.settings.port,改为数字值 - 若改端口后仍报错,终端里运行
lsof -i :5500(macOS/Linux)或netstat -ano | findstr :5500(Windows)查 PID,再kill -9 [PID]或任务管理器结束进程
最常被忽略的一点:Live Server 不会自动监听子目录里的 HTML 更改,也不支持多入口配置。如果你的页面结构是 pages/home.html + pages/about.html,得手动把 pages 设为工作区根,或者用符号链接绕过——它本质上是个轻量级开发服务器,不是 Webpack Dev Server。










