先确认插件是否正确安装并启用:认准作者ritwickdey、图标?的live server,安装后需重启vscode或点击“enable”激活;若命令面板输入“live server: open with live server”提示未找到,则说明未装好。

Live Server插件没反应?先确认是否已正确安装并启用
VSCode里按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)打开命令面板,输入 Live Server: Open with Live Server,如果提示“command not found”,说明插件根本没装好。不是所有叫“Live Server”的都靠谱——认准作者是 ritwickdey 的那个,它在扩展市场里显示为 Live Server(图标是 ?),安装后需重启 VSCode 或点击右下角弹出的“Enable”按钮激活。别装错成 Live Preview 或 Auto Open Browser,它们不提供热重载和端口监听功能。
快捷键失效时,检查文件类型和当前活动编辑器
Alt+L Alt+O 是默认快捷键,但只对以下情况生效:
• 当前打开的是 .html、.htm 或 .svelte 文件(其他如 .js 或 .css 单独打开不会触发)
• 编辑器焦点在该 HTML 文件标签页上(不能是终端、设置页或未保存的 Untitled-1)
• 文件已保存到磁盘(Live Server 不支持预览未保存的临时文件)
• 工作区根目录下没有 package.json 且启用了 liveServer.settings.CustomBrowser 指向 Chrome 但 Chrome 实际未安装,也可能静默失败——此时手动执行命令更可靠。
启动后页面打不开?重点查端口占用和防火墙拦截
Live Server 默认监听 http://127.0.0.1:5500,常见问题包括:
• 另一个程序(比如另一个 VSCode 窗口、Python 的 http.server、Docker 容器)占用了 5500 端口 → 修改配置项 liveServer.settings.Port 换成 8080 或 3000
• Windows 防火墙/杀毒软件阻止了本地回环连接 → 临时关闭防火墙测试,或在防火墙入站规则中放行 node.exe
• 浏览器强制 HTTPS(如访问过 https://127.0.0.1:5500)→ 清空地址栏,完整输入 http://127.0.0.1:5500,不要省略 http://
• 使用 WSL 或远程开发时,服务实际运行在远端,需把 liveServer.settings.AdvanceCustomBrowserCmdLine 设为 "--host=0.0.0.0" 并配好端口转发
想让 CSS/JS 修改自动刷新?不用额外配置,但要注意保存时机
Live Server 的热重载依赖文件系统事件,所以:
• 必须显式保存(Ctrl+S)HTML、CSS 或 JS 文件,Ctrl+Z 撤销后没保存 = 不触发刷新
• VSCode 的“Auto Save”设为 afterDelay 或 onFocusChange 才有效,设为 off 就等于没开
• 如果用 Sass/Less 编译,确保输出的 .css 文件被保存,而不是仅 watch 编译但不写入磁盘
• 修改 index.html 中引用的 script 路径后,要等浏览器重新加载整个页面,不是局部刷新











