Live Server 必须将 host 设为 0.0.0.0、端口设为 3000/8080 并重启,手机访问需用 http://192.168.x.x:3000/ 地址且资源引用必须全用相对路径,调试时 launch.json 的 url 要严格匹配该地址。

Live Server 必须启用 0.0.0.0 才能局域网访问
默认的 127.0.0.1 只绑定本机,手机或同事电脑根本连不上。不是网络没通,是服务压根没监听外部请求。
打开 VSCode 设置(Ctrl+,),搜 liveServer.settings.host,把值改成 0.0.0.0;再搜 liveServer.settings.port,建议设成 3000 或 8080 这类常见端口——避免被杀毒软件或公司防火墙拦截。
- 改完设置后,必须重启 Live Server:右下角点
Go Live按钮两次(先停再启) - 启动成功后,终端输出里会显示类似
http://192.168.x.x:3000/index.html的地址,这才是手机浏览器该输的 URL - Windows 用户注意关闭“专用网络”防火墙规则,或手动放行对应端口
手机访问空白页?检查路径和协议
手机浏览器打开 http://192.168.x.x:3000/about.html 却只显示白屏,大概率是 HTML 里用了绝对路径或硬编码协议。
所有资源引用必须用相对路径:./css/style.css、../js/main.js、fetch('./data.json') —— 不能写 http://127.0.0.1:5500/css/style.css 或 file:///C:/project/css/style.css。
立即学习“前端免费学习笔记(深入)”;
-
<a href="about.html">✅ 正确;<a href="/about.html">❌ 错误(/ 开头会跳到根域名,不是项目根目录) - ES 模块导入也一样:
import { foo } from './utils.js'✅;import { foo } from '/utils.js'❌ - 手机上不要用 Safari 直接输 IP 地址——它会自动补
https://导致失败,务必手动敲http://
调试 JS 时 launch.json 的 url 必须严格匹配 Live Server 地址
VSCode 调试器连不上 Chrome,90% 是因为 launch.json 里的 url 还写着 http://localhost:8080 或 http://127.0.0.1:5500,而你实际用的是 http://192.168.x.x:3000。
最简配置只改两处:url 填完整地址(如 "http://192.168.1.100:3000/index.html"),webRoot 保持 "${workspaceFolder}" 不变。
- 别信网上抄来的旧配置,尤其是带
file:协议或localhost的版本——那根本没法跨设备调试 - 如果手机上要调试,得用 Chrome for Android + USB 调试,VSCode 无法直接 attach 到手机浏览器
- 断点生效前,确保 Chrome 已禁用缓存(DevTools → Network → ✅ Disable cache)
端口冲突或插件不响应?先看状态栏和输出面板
点了 Go Live 没反应,或右键菜单里没有 Open with Live Server,不是插件坏了,而是触发条件没满足。
关键前提:当前编辑器标签页必须是已打开的 .html 文件(不是文件夹、不是未保存的 Untitled-1、不是 .css/.js 文件)。
- 状态栏右下角没出现绿色
Go Live按钮?说明没打开 HTML 文件 - 点击后弹出错误提示
Port 3000 is already in use?用命令行跑lsof -i :3000(macOS/Linux)或netstat -ano | findstr :3000(Windows)查 PID 并 kill - 还是不行?按
Ctrl+Shift+U打开输出面板,选Live Server,看具体报错——比如路径含中文、文件名带空格、或插件权限被系统拦截


















