VS Code Live Server无法自动刷新页面，手动刷新才生效求助

云上老周

2026-6-13

针对Live Server/FiveServer自动刷新失效的排查方案

检查页面JS错误：打开浏览器开发者工具（F12）的Console标签，查看是否有未捕获的JavaScript语法错误或运行时错误。这类错误会阻塞页面脚本执行，包括Live Server注入的自动刷新监听脚本，导致无法触发刷新。修复JS错误后再测试。
排查Live Server排除文件配置：打开VS Code的设置（Ctrl+,），搜索liveServer.settings.excludeFiles，检查是否误将项目中的JS文件、HTML/CSS文件路径添加到排除列表中。如果有，移除对应的规则。示例配置：
```
"liveServer.settings.excludeFiles": [
    ".vscode/**",
    "**/*.scss",
    "**/*.sass"
]
```
确保你的业务文件不在排除范围内。
清理后台残留进程：打开Windows任务管理器，找到所有node.exe进程并结束，然后重启VS Code和Live Server。有时候后台残留的Live Server进程会导致文件监听异常。
检查项目路径合法性：确保项目所在路径没有中文、空格或特殊符号（比如!@#$等）。Live Server的文件监听模块对非ASCII路径兼容性较差，可能导致无法检测文件变更。
禁用冲突扩展：临时禁用VS Code中除Live Server/FiveServer外的其他扩展（比如代码格式化、缓存管理类扩展），然后测试自动刷新是否恢复。如果恢复，逐个启用扩展排查冲突项。
验证WebSocket连接状态：打开浏览器开发者工具的Network标签，筛选“WS”类型，查看是否存在来自Live Server的WebSocket连接（通常路径为/livereload）。如果连接状态为“Failed”或“Closed”，检查Windows Defender防火墙或第三方杀毒软件是否拦截了WebSocket请求，可临时关闭安全软件测试。
调整Live Server核心设置：
- 启用liveServer.settings.useLocalIp，使用本地IP而非localhost启动服务；
- 禁用liveServer.settings.CustomBrowser，使用系统默认浏览器；
- 开启liveServer.settings.AdvanceCustomBrowserCmdLine，手动指定浏览器启动命令（比如"chrome.exe --incognito"）。