Sublime Text 4 不支持 LiveReload 插件,需用 livereload CLI 或 browser-sync 配合浏览器扩展实现保存即刷新;必须通过 http:// 协议访问页面,且确保三端(CLI、WebSocket 服务、浏览器扩展)全部正确配置并协同工作。

Sublime Text 本身不支持保存即刷新,所谓“热更新”必须三端协同:文件监听器(Sublime 插件或 CLI)、WebSocket 服务(livereload 或 browser-sync)、浏览器扩展(Chrome LiveReload)。缺一环,就静默失败——你按了 Ctrl+S,页面纹丝不动,控制台也没报错,这才是最坑的。
Sublime Text 4 用户别装 LiveReload 插件
ST4 上 LiveReload 插件(作者 dwieeb)已彻底失效:不注册命令、状态栏无图标、Ctrl+Shift+P 找不到 LiveReload: Enable。它只兼容 ST3,官方没更新,社区无维护分支。你看到的“启用成功”全是假象。
- ST4 正确做法:卸载所有 LiveReload Sublime 插件,改用
livereloadCLI 或browser-sync - 全局安装 CLI:
npm install -g livereload,然后在项目根目录运行livereload . -e html,css,js - 端口默认是
35729,浏览器扩展必须设为监听该端口(右键图标 → Options → Port)
浏览器必须走 http:// 协议,file:// 路径下必然失败
Chrome 的 LiveReload 扩展在 file:// 路径下被安全策略直接禁用 WebSocket 连接,所以双击打开 HTML 文件永远不刷新。这不是插件问题,是浏览器铁律。
- 用 Python 快速起服务:
python -m http.server 8000,然后访问http://localhost:8000/index.html - 用
browser-sync更稳:browser-sync start --server --files "**/*.html,**/*.css,**/*.js" - 注意:
--files参数必须显式列出后缀,"*.css"不会匹配子目录,要写成"**/*.css"
LiveReload 扩展启用状态容易被忽略
Chrome 扩展图标亮起 ≠ 已启用当前页面。很多用户点了图标,圆圈变实心,但忘了在目标标签页上再点一次——它只对当前激活标签生效。
- 打开页面后,务必点击地址栏右侧 LiveReload 图标,确认中间圆点为实心(不是空心或灰色)
- 如果页面是通过
http://localhost:3000打开的,但扩展设置里 Hosts 写了127.0.0.1,也会失败 - 检查 DevTools Console:若看到
WebSocket connection to 'ws://localhost:35729/livereload' failed,说明服务没起来或端口不对
真正卡住人的从来不是配置步骤多,而是三端中某一个环节“看起来正常却实际断连”:ST4 插件静默失效、file:// 协议被拦截、扩展图标亮着但没作用于当前页。盯住这三点,比反复重装插件管用得多。


















