LiveReload 在 Sublime 中需三端协同:Sublime 插件(仅发通知)、浏览器扩展(监听 WebSocket)和服务端(livereload CLI),缺一不可;ST4 不兼容原插件,端口与协议(必须 http/https)必须严格一致。

LiveReload 在 Sublime 里根本不是“装个插件就自动好使”的东西
Sublime Text 本身不支持 LiveReload 协议,所谓“LiveReload 插件”只是个监听器——它只负责在你保存文件时发个通知,真正干活的是浏览器扩展和后台服务。如果你按网上教程装了插件却没反应,大概率是卡在这一步:没有配套的浏览器扩展,或没启动服务端。
-
livereloadCLI 必须用npm install -g livereload全局安装(确认已装 Node.js) - 浏览器必须装官方 LiveReload 扩展(Chrome 网上应用店搜 “LiveReload”,图标是黑白靶心,开发者是 LiveReload.com)
- 网页必须通过
http://localhost或https://打开,file://协议下扩展被浏览器禁用,这是硬性限制,改不了 - Sublime Text 4 用户注意:
LiveReload插件(作者 dwieeb)只支持 ST3,ST4 上静默失效,别白费时间配置
启动服务时端口不一致是“保存没反应”的头号原因
CLI 默认监听 35729 端口,浏览器扩展也默认连这个端口;只要有一边改了,另一边没同步,WebSocket 就连不上,控制台会报 WebSocket connection to 'ws://localhost:35729/livereload' failed。
- 启动命令示例:
livereload . --port 35729 --exts html,css,js,md -
--exts必须显式列出你要监听的后缀,漏掉css,改样式就不会刷新 - 如果提示
EADDRINUSE,说明端口被占,换--port 35730,同时进浏览器扩展的Options页面把 port 改成一样 - 别加
--no-browser——这参数只是不让服务自动开新标签页,跟 Sublime 刷新完全无关
Markdown 实时预览要绕过插件默认逻辑
LiveReload 插件默认不监听 .md 文件,因为它不直接生成 HTML;而 Markdown Preview 插件是把渲染结果写到缓存目录下的临时 .html 文件里。所以得手动告诉 LiveReload:“当 .md 保存时,请触发 markdown_preview 命令,并把输出当作 HTML 刷新”。
- 打开
Preferences → Package Settings → LiveReload → Settings – User - 填入:
{ "enabled_plugins": ["SimpleReloadPlugin"], "SimpleReloadPlugin": { "paths": ["*.md"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"} } } -
"command"必须是markdown_preview(全小写+下划线),写成MarkdownPreview或其他变体都不生效 - 确保已安装
Markdown Preview(不是MarkdownEditing),且没装已弃用的Markdown Live Preview
CSS 预处理器(Sass/Less)编译后自动刷新要分两步走
LiveReload 不会帮你编译 .scss 或 .less,它只管刷新。编译得靠别的插件(如 Sass 或 Less2Css)或 CLI 工具(sass / lessc)。关键在于让编译完成的 .css 文件落在 LiveReload 的监听路径里。
- 推荐用
sass --watch或构建系统输出到项目根目录下的css/目录,再让 LiveReload 监听该目录 - 如果用
livereload . --exts scss,css,它不会自动编译.scss,只会等你手动产出.css后才刷新 - 更稳的组合是:
npm install -g sass+livereload . --exts css+ 浏览器扩展,把编译和刷新解耦 - 别指望一个插件干完所有事——Sass Build 插件和 LiveReload 插件各司其职,强行绑定反而容易出错
最容易被忽略的其实是协议和端口的一致性:哪怕所有步骤都对,只要页面是 file:// 打开的,或者 CLI 和浏览器扩展端口差一位数,整个流程就卡死。调试时先看浏览器控制台有没有 WebSocket 报错,比反复重装插件快得多。
















