livereload cli 必须全局安装并手动启动,sublime 插件仅在保存时触发通知;真正监听文件、建立 websocket 并广播变更的是 livereload cli 工具,sublime text 本身不运行该服务。

LiveReload CLI 必须手动启动,Sublime 插件只是发通知
Sublime Text 本身不运行 WebSocket 服务,LiveReload 插件(比如 dwieeb 版)在 ST4 上已静默失效,ST3 上也仅是“保存时调用 livereload CLI”的触发器。它不监听文件、不建连接、不广播变更——真正干活的是 Node.js 的 livereload CLI 工具。
必须执行:
npm install -g livereload- 在项目根目录运行:
livereload . --port 35729 --exts html,css,js,md -
--exts必须显式包含css,否则改样式不会触发刷新 -
--port默认是35729,浏览器扩展和 CLI 必须严格一致;若提示EADDRINUSE,换端口(如--port 35730),并同步更新浏览器扩展的 Options 设置
浏览器扩展必须启用且只认 http:// 协议
Chrome / Edge 必须安装官方 LiveReload 扩展(图标是黑白靶心,开发者为 LiveReload.com),其他同名插件大多无效。安装后需手动点击地址栏旁图标,使其变为实心状态,并确认右下角显示 LiveReload is connected。
硬性限制:
- 页面必须通过
http://localhost:8000/xxx.html这类地址打开,file://协议下扩展会被浏览器直接禁用,无法绕过 - 若页面已在浏览器中打开后再装扩展,需手动按
Ctrl+R重载一次,让注入脚本生效 - 扩展设置里要勾选
Allow access to file URLs(仅对本地调试必要,但非充分条件)
Markdown 实时预览需靠 SimpleReloadPlugin 配合 markdown_preview
livereload CLI 默认不处理 .md 文件,因为 Markdown 不是可直接渲染的 HTML。真正起作用的是 Markdown Preview 插件把内容转成临时 HTML 后,再由 SimpleReloadPlugin 触发刷新。
配置路径:Preferences → Package Settings → LiveReload → Settings – User,填入:
{
"enabled_plugins": ["SimpleReloadPlugin"]
}
同时确保 Markdown Preview 的 enable_autoreload 为 true(在 Preferences → Package Settings → Markdown Preview → Settings 中设置)。
别指望 Sublime 做 Webpack HMR,它只能刷页面
Sublime Text 本身不运行 webpack-dev-server,也不支持 module.hot.accept() 这类 runtime 注入机制。所谓“热更新”,它只能配合外部服务实现文件保存 → 构建 → 浏览器刷新,不是 Webpack 原生的模块热替换。
如果你需要错误行号跳转,关键不在 LiveReload,而在 Build System 和 sourcemap 格式匹配:
-
webpack.config.js中设devtool: 'source-map' - Build System 文件(如
Webpack.sublime-build)中确保"cmd": ["npx", "webpack"],且含"shell": true和"working_dir": "${project_path}" - 错误输出不能被重定向或过滤:去掉
--no-color,不要用2>&1 | grep类管道,否则 Sublime 捕获不到./src/App.js:12:5这种标准格式
真正容易被忽略的是:LiveReload 不启动服务器,你仍得自己起一个 HTTP 服务(比如 python -m http.server 8000 或 browser-sync start --server --files "*.html, *.css"),否则连页面都打不开——这个环节断了,后面全白配。











