Live Server启动慢或刷新卡顿的根本原因是文件监视器被node_modules等目录拖垮;必须在项目级.vscode/settings.json中配置files.watcherExclude排除无关目录,否则自动刷新失效。

Live Server 启动慢或刷新卡顿
根本原因不是 Live Server 本身慢,而是它依赖的文件监视器被大量无关文件拖垮。只要 node_modules、dist、.git 这些目录没排除,每次保存 HTML 或 JS 文件,VSCode 就要处理成千上万个文件变更事件,导致 Live Server 响应延迟甚至假死。
必须在当前项目根目录的 .vscode/settings.json 中配置,而不是用户级设置:
{
"files.watcherExclude": {
"**/node_modules/**": true,
"**/dist/**": true,
"**/.git/**": true,
"**/logs/**": true,
"**/__pycache__/**": true
}
}
- Windows 用户若仍卡顿,可加一行
"files.useExperimentalFileWatcher": false - 别只信扩展界面里的“启用自动刷新”开关——没配好
watcherExclude,那开关只是个摆设 - Live Server 默认端口是 5500;如果看到状态栏显示
Port: 5500但浏览器打不开,大概率是端口被占,右键状态栏该提示 → “Change Port” 换一个
HTML 文件保存后不自动刷新
这通常不是 Live Server 故障,而是 VSCode 的保存行为和扩展协作出了问题。比如你开了 editor.formatOnSave,又装了 Prettier,保存时先格式化再触发 Live Server,中间有毫秒级延迟,肉眼可能感知为“没刷新”。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 确认
liveServer.settings.donotShowInfoMsg没被设为true(否则连启动成功提示都关了) - 检查是否误启用了
liveServer.settings.AdvanceCustomBrowserCmdLine并填了错误命令,会导致刷新逻辑中断 - 临时验证:关闭所有其他扩展,只留 Live Server,再试一次保存 → 刷新。如果好了,说明是扩展冲突
- 不要在
settings.json里写"liveServer.settings.port": 0,设为 0 表示随机端口,反而容易引发跨域或刷新失败
用浏览器直接打开 HTML 时响应迟钝
这不是 VSCode 的问题,但常被误认为编辑器卡。典型表现是:拖拽 HTML 文件到 Chrome 标签页后,页面空白几秒才渲染,或者修改后按 Ctrl+R 刷新特别慢。
立即学习“前端免费学习笔记(深入)”;
- Chrome 地址栏显示
file:///路径时,浏览器会禁用部分 API(如fetch本地 JSON、Service Worker),也会影响加载逻辑 - 避免用资源管理器右键 → “Open with Chrome”,这种调用方式可能触发旧版 Chrome 渲染路径,尤其在 Windows 上
- 真要临时测试,用终端执行:
open -a "Google Chrome" ./index.html(macOS)或start chrome ./index.html(Windows)更可靠 - 如果 HTML 引用了相对路径的 JS/CSS,且目录结构深,
file://协议下部分路径解析会失败——这是浏览器限制,不是代码 bug
HTML 编辑时输入卡顿、光标延迟
很多人以为是 Live Server 在后台捣鬼,其实真正凶手常是其他扩展在监听 HTML 文件变化。比如 Auto Rename Tag、Auto Close Tag、ESLint(即使没配 HTML 规则)都会在你敲 < 或 > 时实时分析 DOM 结构。
- 运行命令
Developer: Show Running Extensions,看哪些扩展的Activation Time超过 300ms,重点关注名字带 “auto”、“tag”、“lint”、“format” 的 - HTML 文件类型默认启用
html.suggest.html5,但如果你关了它,某些补全会失效;开是常态,关需明确理由 - 别在
settings.json里加"html.validate.scripts": false来“提速”——它只关校验,不减卡顿,还掩盖真实错误 - 最狠但最有效的一招:
code --disable-extensions ./my-project启动,再开 HTML 文件试试。如果丝滑了,就一个个启用扩展排查
files.watcherExclude 配不全比没装 Live Server 更致命。很多人配了却放在用户设置里,结果新开一个没 .vscode 目录的项目,照样卡。这点最容易被忽略。

















