live server插件必须在工作区(文件夹)中打开已保存的.html文件才能启动,否则右键无选项、地址栏显示file://协议,导致fetch、import等现代web功能全部失效;核心判断标准是浏览器地址栏是否为http://127.0.0.1:5500/xxx.html。

直接装 Live Server 插件,别试其他快捷方式——它才是真正能跑现代 HTML 的方案,不是“看起来能打开”就行。
为什么右键没出现 Open with Live Server
这不是插件没装好,而是 VS Code 没拿到合法的 HTML 上下文。
- 必须用「文件 → 打开文件夹」加载整个目录,不能只拖一个
index.html进来;侧边栏显示的是文件夹结构,不是一堆标签页 - 文件得已保存,且后缀是
.html或.htm;未保存的Untitled-1标签右键不会出该选项 - 右下角语言模式得是
HTML,不是Plain Text或JavaScript;点右下角文字手动切过去 - 插件状态得是启用:按
Ctrl+Shift+X搜ritwickdey.liveserver,看右边是否显示“已启用”
点了 Go Live 却打不开浏览器或地址栏还是 file://
说明根本没走 HTTP 服务,等于白点。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 地址栏显示
file:///开头?那一定是用了「Open in Default Browser」之类插件,和Live Server无关——立刻停用 - 状态栏没显示
Go Live或端口号(如5500)?说明服务根本没启动,检查是否在正确文件上右键,或重启 VS Code 后重试 - 报
Unable to launch browser?不是端口问题,而是系统默认浏览器调用失败;Windows 可在设置里加"liveServer.settings.CustomBrowser": "chrome",macOS 需确保Chrome已设为默认 - Linux 用户注意:
$BROWSER环境变量没设会导致静默失败,终端运行echo $BROWSER确认有值
改了代码但页面不刷新
Live Server 不监听所有文件,只盯它认为“相关”的路径和类型。
- 只监听当前
.html文件所在目录及子目录下的.html、.css、.js;改同级的README.md或上级目录的utils.js不会触发 - 确认 VS Code 是“自动保存”:设置
files.autoSave为"onFocusChange"或"onDelay","off"时 Ctrl+S 才算数 - 检查
liveServer.settings.ignoredFiles,别误加了"**/*.css"这种全局忽略 - 浏览器可能缓存旧资源:DevTools → Network 标签页勾选
Disable cache,或 Ctrl+F5 强刷
能打开但 fetch 报 CORS 或 import 失败
这是最隐蔽也最致命的问题:你以为在“运行”,其实还在 file:// 协议里裸奔。
- 打开页面后看地址栏——必须是
http://127.0.0.1:5500/xxx.html,不是file:///;否则fetch('./data.json')、import、相对路径 CSS/JS 全都会挂 - 如果用了
./assets/style.css,而 HTML 在pages/about.html,请求实际发向http://127.0.0.1:5500/pages/assets/style.css;想从根目录找就写/assets/style.css - 跨域调本地 API?
Live Server不代理,必须确保 API 服务和 HTML 同源(同端口),或换用Vite/Webpack Dev Server等带代理能力的工具
真正关键的判断标准只有一个:地址栏是不是 http://。其它都是障眼法。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










