Live Server 默认绑定 127.0.0.1 导致外部设备无法访问,需改为 0.0.0.0 并检查端口、防火墙、工作区根目录及 HSTS 缓存问题。

Live Server 默认绑定 127.0.0.1,外部设备打不开
VSCode 的 Live Server 插件默认只监听本地回环地址 127.0.0.1,所以你在手机、平板或另一台电脑上用 IP 访问(比如 http://192.168.x.x:5500)时,会直接被拒——不是网络问题,是服务压根没在那个网卡上监听。
解决办法是让插件改用 0.0.0.0 绑定,开放给本机所有网络接口:
- 打开 VSCode 设置(
Ctrl+,或Cmd+,),搜live server config - 找到
Live Server > Settings: Host,把值从默认的127.0.0.1改成0.0.0.0 - 顺手检查
Live Server > Settings: Port是否被占用(比如被 Python 的http.server占了 5500),可改成5501等空闲端口 - 重启 Live Server(点右下角「Go Live」按钮两次,或先停再启)
防火墙或路由器阻止了局域网访问
即使绑定了 0.0.0.0,Windows/macOS 防火墙也可能拦截入站连接,尤其是非 localhost 的请求。Mac 用户还要注意「共享」里的「互联网共享」是否意外开启,它会干扰本地网络路由。
快速验证和处理:
- 在同局域网的另一台设备浏览器里访问
http://你的电脑IP:端口(如http://192.168.1.10:5500),如果显示「拒绝连接」而非「无法访问此网站」,大概率是防火墙挡了 - Windows:进「Windows 安全中心 > 防火墙和网络保护 > 允许应用通过防火墙」,找到
Code.exe,勾选「专用」和「公用」 - macOS:系统设置 > 网络 > 防火墙 > 防火墙选项,确保没启用「阻止所有传入连接」;也可临时关闭防火墙测试
- 路由器一般不用动,除非你开了 AP 隔离(常见于公共 Wi-Fi 或某些企业路由器),此时设备间根本不能互访
VSCode 工作区根目录不对,导致路径 404
Live Server 启动的是当前打开文件所在**文件夹的根路径**,不是整个项目最外层。比如你打开了 src/index.html,但没把 src 文件夹设为 VSCode 工作区根目录,那它实际监听的是上层目录,index.html 就不在服务根下,访问时会 404。
确认并修正:
- 看 VSCode 左下角状态栏,显示的是哪个文件夹路径?那是 Live Server 的根
- 如果不对,用「文件 > 将文件夹添加到工作区」,选对包含
index.html的那一层目录 - 或者直接右键
index.html→ 「Open with Live Server」,它会以该文件所在目录为根启动(比点击右下角按钮更可靠) - 别依赖「Go Live」按钮自动推断——它只认当前工作区根,不认当前活动文件位置
HTTPS / HSTS 导致跳转失败或白屏
如果你之前用过 HTTPS 服务(比如 Vite、Webpack Dev Server 开过 https: true),浏览器可能对这个域名(localhost 或你的局域网 IP)缓存了 HSTS 策略,强制跳 HTTPS。而 Live Server 只支持 HTTP,结果就是空白页、重定向循环或 ERR_SSL_PROTOCOL_ERROR。
临时绕过方法(仅调试用):
- Chrome 地址栏输入
chrome://net-internals/#hsts→ 在「Delete domain security policies」里输入你的局域网 IP(如192.168.1.10)→ Delete - 或者换一个没访问过的端口(比如从
:5500换成:5502),避免策略命中 - 终极保险:用无痕窗口访问,HSTS 不生效
这事容易被忽略,尤其当你刚从其他开发服务器切过来,页面明明跑起来了却一片空白,八成是它。


















