Live Server 是必须安装的插件,因双击或右键“Open with Browser”使用 file:// 协议会拦截 fetch、import 和多页面跳转,报 net::ERR_FILE_PROTOCOL;它启动真实 HTTP 服务(默认 http://127.0.0.1:5500),确保相对路径、模块加载和本地 API 全部正常工作。

Live Server 是必须装的插件,不是可选项
Mac 上双击 HTML 文件或用 VSCode 右键“Open with Browser”打开,页面能显示,但只要涉及 fetch('./data.json')、import 模块、跨页面跳转(比如 <a href="about.html">),立刻失败——控制台报 net::ERR_FILE_PROTOCOL。这不是代码问题,是 Safari 和 Chrome 主动拦截 file:// 协议下的资源请求。Live Server 启动的是真实 HTTP 服务(默认 http://127.0.0.1:5500),所有相对路径、模块加载、本地 API 调用全部走通。
安装方式:VSCode 左侧扩展图标 → 搜索 Live Server → 找到作者为 Ritwick Dey 的那个 → 点击 Install。装完不用重启,但必须确保当前已通过 File → Open Folder 打开整个项目文件夹,否则右键菜单里不会出现 Open with Live Server 选项。
右下角 “Go Live” 按钮点不亮?检查三个硬性条件
Live Server 插件装好了,但右下角没出现 Go Live 按钮,或点了没反应,常见原因就三个:
- 当前编辑器里没打开任何
.html文件(哪怕只是空标签也得有) - VSCode 没以文件夹形式打开项目(即没执行
Open Folder,只打开了单个文件) - 项目根目录下没有
.html文件(Live Server 默认只对根目录或子目录里的 HTML 文件生效)
验证方法:在资源管理器中选中一个 index.html,再点右键,如果菜单里有 Open with Live Server,说明插件已就位;如果连这个都没有,优先检查是否打开了文件夹。
立即学习“前端免费学习笔记(深入)”;
多页面跳转必须用相对路径,别写 file:/// 或 http://localhost:5500/
Live Server 启动后地址是类似 http://127.0.0.1:5500/index.html 这样的,但你写链接时绝不能硬编码端口或协议。所有跳转必须用纯相对路径:
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
- ✅ 正确:
<a href="about.html">关于</a>、<a href="contact/index.html">联系</a> - ❌ 错误:
<a href="file:///Users/xxx/my-site/about.html">、<a href="http://localhost:5500/about.html">
原因:Live Server 的根目录就是你 Open Folder 的那个文件夹,它自动把路径映射到 / 下。一旦写死端口或绝对路径,换机器、换端口、部署到真实服务器时全挂。
端口被占或想换域名?改 settings.json 就行
默认端口 5500 被其他程序占了,或者你想让地址变成 http://my-site.test 这种更像生产环境的形式,不用重装插件,直接改配置:
按下 Cmd + , 打开设置 → 点右上角「打开设置 (JSON)」图标 → 在 settings.json 里加这几行:
{
"liveServer.settings.port": 8080,
"liveServer.settings.host": "127.0.0.1",
"liveServer.settings.root": "/my-site"
}
"root" 是可选的,只在你项目嵌套在子目录里、但想把它当根来跑时才需要填。改完保存,重启 Live Server(关掉再点一次 Go Live)即可生效。
真正容易被忽略的是:Live Server 不处理 404 页面重定向,也不支持服务端路由。如果你做的是 SPA(比如用 history.pushState),刷新页面会 404——这时候就得换 http-server 或 vite 这类支持 fallback 的工具了。


















