VSCode本身不运行HTML,所谓“运行慢”实为Live Server启动慢、浏览器刷新卡顿或终端脚本延迟;根源在插件配置、文件监听范围及浏览器联动方式。

VSCode 本身不运行 HTML,所谓“运行慢”其实是 Live Server 启动慢、浏览器刷新卡顿、或终端执行脚本延迟——问题不在编辑器,而在插件配置、文件监听范围和浏览器联动方式。
Live Server 启动慢或刷新延迟
Live Server 插件默认每次启动都扫描整个工作区、监听所有文件变更,一旦项目含 node_modules 或大量静态资源,就会明显卡顿;刷新时还可能因缓存策略或跨域设置阻塞。
- 在
.vscode/settings.json中显式排除无关目录:"liveServer.settings.donotVerifyTags": true(跳过 HTML 标签校验)、"liveServer.settings.AdvanceCustomBrowserCmdLine": "chrome --disable-web-security --user-data-dir=/tmp/chrome"(仅调试用,避免跨域干扰) - 禁用自动打开浏览器:
"liveServer.settings.NoBrowserOpen": true,改用手动 Ctrl+Click 链接,避免每次保存都触发新进程 - 别把 Live Server 当 Webpack 用:它不支持热模块替换(HMR),大型单页应用建议直接用
npx serve -s dist或python3 -m http.server 8000
HTML 文件保存后响应迟钝
不是 HTML 渲染慢,而是 VSCode 在保存瞬间触发了 ESLint、Prettier、Auto Rename Tag 等插件的 on-save 检查,尤其当 node_modules 被监听时,文件系统事件堆积导致 UI 假死。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 检查
files.watcherExclude是否生效:必须写在工作区根目录的.vscode/settings.json中,且至少包含:"**/node_modules/**": true、"**/dist/**": true、"**/.git/**": true - 关闭非必要 on-save 功能:在设置中搜
editor.formatOnSave、editor.codeActionsOnSave,设为false或只对特定语言启用 - Live Server 的刷新逻辑依赖文件变更事件,如果
files.useExperimentalFileWatcher为true(Windows 默认),反而容易在某些 SSD + NTFS 组合下失灵,可手动设为false
浏览器预览卡、F5 刷新白屏或加载慢
这通常和 VSCode 无关,而是 Live Server 默认端口被占用、本地 DNS 解析异常、或浏览器扩展(如广告拦截器、React DevTools)劫持了 localhost 请求。
立即学习“前端免费学习笔记(深入)”;
- 换端口启动:
"liveServer.settings.port": 5501,避开被杀毒软件或企业防火墙拦截的常见端口(如 5500、8080) - 禁用浏览器中可能干扰的扩展:临时开无痕窗口测试,确认是否为插件冲突
- 避免用
file://协议双击打开 HTML:它不支持fetch()、import或 Service Worker,必须走 HTTP 服务 - 若用 Chrome,检查地址栏是否显示“不安全”警告——说明证书异常,Live Server 默认不提供 HTTPS,不要强行配
https: true
最常被忽略的是:Live Server 启动后,VSCode 仍会持续监听所有 HTML 文件变更,哪怕你只改了一个 index.html。只要 files.watcherExclude 没配全,或者用了 Remote - SSH 扩展却没在远程环境里重装 Live Server,性能问题就会反复出现。

















