根本原因是LiveReload插件默认不启用任何子插件,Package Control安装的仅为“空壳”,必须手动在Settings–User中配置{"enabled_plugins": ["SimpleReloadPlugin", "SimpleRefresh"]}并重启;Chrome图标空心表示未建立WebSocket连接,需开启扩展“允许访问文件网址”、通过http://而非file://协议打开页面,并点击图标激活;Markdown预览需配合LiveReload链路而非仅依赖enable_autoreload;因维护停滞及现代浏览器兼容性问题,推荐改用BrowserSync。

LiveReload插件在Sublime Text 3里为什么装了没反应
根本原因不是没装上,而是默认不启用任何子插件。Package Control安装的LiveReload只是一个空壳,所有功能都靠手动启用具体插件来激活。
常见错误现象:Ctrl+S保存后浏览器毫无反应;命令面板里搜到LiveReload: Enable/disable plug-ins但点了没变化;Chrome图标始终是空心圆。
- 必须打开
Preferences → Package Settings → LiveReload → Settings – User,写入启用配置:{"enabled_plugins": ["SimpleReloadPlugin", "SimpleRefresh"]} - 重启Sublime Text或重载插件(
Ctrl+Shift+P→Package Control: Satisfy Dependencies) - 如果仍无效,说明插件目录结构异常——优先用Git方式安装:
git clone https://github.com/Grafikart/ST3-LiveReload.git LiveReload到Packages目录下
Chrome LiveReload插件打不开或图标不实心
图标空心 = 插件已安装但未与当前页面建立连接。这不是Sublime的问题,而是浏览器端权限或注入失败导致的。
使用场景:本地直接双击打开file:///路径的HTML文件,或通过View in Browser插件打开。
- 进Chrome扩展管理页(
chrome://extensions/),确保LiveReload右侧「允许访问文件网址」开关已打开 - 用
Ctrl+Alt+V(或右键→View in Browser)打开HTML,而不是双击文件——后者常因CSP策略阻止JS注入 - 页面加载完成后,再点击地址栏右侧的LiveReload图标,等它变成实心圆点才真正激活监听
- 若页面含
<meta http-equiv="Content-Security-Policy">,需临时移除,否则livereload.js无法注入
enable_autoreload对Markdown Preview不管用
enable_autoreload是MarkdownPreview插件自己的开关,和LiveReload完全无关。两者机制不同:前者靠轮询文件修改时间,后者靠WebSocket通信。
如果你用MarkdownPreview预览,想实现保存即刷新,必须走LiveReload链路,不能只改MarkdownPreview.sublime-settings。
- 确认
MarkdownPreview输出的是本地file://URL(不是http://) - Chrome中打开该URL后,手动点LiveReload图标激活
- 别依赖
"enable_autoreload": true——这个设置只对内置的简单刷新有效,且不稳定,2026年多数用户反馈已失效 - 如需纯Markdown流,可改用
mkdocs serve或python -m http.server起本地服务,再配合LiveReload监听_site或docs目录
为什么推荐换用BrowserSync而不是LiveReload
LiveReload维护早已停滞,GitHub最后更新是2019年;其核心依赖的livereload.js在现代Chrome中偶发注入失败,且不支持HTTPS本地服务、移动端调试、多设备同步等基本需求。
复杂点在于迁移成本低但认知惯性高——很多人卡在“我以前配好了,现在为啥不行”,其实不是配错,而是底层HTTP协议栈变了。
- 用
npm install -g browser-sync,然后browser-sync start --files "*.html,*.css,*.js" --server - 自动开
http://localhost:3000,所有设备访问同一地址即可实时同步 - Sublime里保存任意匹配文件,BrowserSync会秒级通知所有连接客户端刷新
- 无需浏览器插件、无需额外配置、无需担心
file://协议限制
真正容易被忽略的是:LiveReload的「实心圆点」状态不可靠,有时看似激活实则WebSocket握手失败;而BrowserSync终端里打印的[BS] Reloading Browsers...才是真实信号。


















