Live Server 默认监听 localhost 导致手机无法访问,需将 host 改为 0.0.0.0、固定 port(如 5500),用电脑局域网 IP(如 192.168.1.105:5500)访问,并放行防火墙端口,确保项目以文件夹为根目录打开且资源路径正确。

Live Server 默认只监听 localhost,手机访问不了
这是最常卡住的地方:VSCode 启动的 Live Server 默认绑定 127.0.0.1,只接受本机请求。手机和电脑不在同一网络,或即使在同一 Wi-Fi 下,也无法通过电脑 IP 访问——因为服务根本没对外暴露。
解决方法是改配置,让服务器监听所有接口:
- 打开 VSCode 设置(
Ctrl+,或Cmd+,),搜live server.settings.host - 把值改成
0.0.0.0(不是localhost,也不是留空) - 同时确保
live server.settings.port设为一个固定端口(比如5500),避免每次启动换端口导致手机书签失效 - 重启 Live Server(点右下角「Go Live」按钮两次)
手机浏览器输什么地址才能连上
不能输 localhost:5500,也不能输 127.0.0.1:5500——那是手机自己的回环地址,和你的电脑无关。
必须用你电脑在局域网中的真实 IP,例如 192.168.1.105:5500。获取方式:
- Windows:命令行运行
ipconfig,找「IPv4 地址」那一行 - macOS:终端运行
ifconfig | grep "inet " | grep -v 127.0.0.1,选192.168.x.x或10.x.x.x开头的 - 手机浏览器直接访问
http://[电脑IP]:5500(注意别漏http://,HTTPS 会失败)
防火墙或路由器可能拦掉请求
即使 IP 和端口都对,手机仍白屏或连接被拒绝,大概率是系统防火墙挡了入站连接。
常见拦截点:
- Windows Defender 防火墙默认阻止非本机访问新端口,需手动放行:
5500端口(协议选 TCP) - macOS 的「防火墙」设置里要勾选「允许远程登录」或「允许来自网络的连接」(具体名称因版本而异)
- 部分企业/学校 Wi-Fi 启用了客户端隔离(Client Isolation),手机和电脑虽连同一 SSID,但互相 ping 不通——换热点或家用路由器即可验证
HTML 文件路径和资源加载容易出错
Live Server 是以当前打开的文件夹为根目录启动服务器的,不是以单个 HTML 文件为准。如果你直接双击打开 HTML,或从其他路径引用资源,手机上就会 404。
务必确认:
- VSCode 左侧资源管理器中,整个项目文件夹已作为「工作区」打开(即能看到
index.html在根目录下) - 页面内所有
<img src="...">、<script src="...">的路径都是相对于该根目录的,别用绝对路径如/assets/logo.png(除非你配了代理) - 如果用了
fetch或XMLHttpRequest加载本地 JSON,确保它也在同源目录下,否则跨域报错:Access to fetch at 'http://192.168.1.105:5500/data.json' from origin 'http://192.168.1.105:5500' has been blocked by CORS policy—— 这其实是假报错,真因是路径错了或文件没放对位置
手机预览这事,关键就三点:绑对 IP、放通防火墙、路径别写崩。其他花哨配置,等这三步走通了再说。


















