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/），所有资源路径必须按服务器根目录解析，不能依赖文件系统相对路径。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- 避免使用
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。
