BrowserSync 必须通过 HTTP 协议(如 http://localhost:3000)运行,file:// 协议下因浏览器禁用脚本注入与跨域请求,所有自动刷新均失效;需全局安装、进入项目根目录执行带 --server 和递归 --files "/.html, /.css" 的命令,并确保浏览器访问 HTTP 地址而非本地文件路径。

BrowserSync 必须走 HTTP,file:// 协议下所有自动刷新都失效
Sublime Text 本身不提供自动同步能力,所谓“保存即刷新”完全依赖外部服务;直接双击 HTML 文件、右键 View in Browser、或用 Open in Browser 插件打开的 file:/// 地址,浏览器会禁用脚本注入和跨域请求,导致 LiveReload、BrowserSync 的 reload 脚本根本加载不了。
真正起作用的前提只有一个:http://localhost:3000(或类似)这类 HTTP 地址访问页面,而不是 file://。
- 确认已安装 Node.js:
node -v和npm -v能输出版本号 - 全局安装:
npm install -g browser-sync - 进入项目根目录(含
index.html),运行:browser-sync start --server --files "**/*.html, **/*.css, **/*.js" - 终端输出
Local: http://localhost:3000后,必须用浏览器打开这个地址——不是双击文件,不是右键预览
--files 参数漏掉 ** 或写错分隔符,监听就静默失效
BrowserSync 默认不递归监听子目录。"*.css" 只匹配根目录下的 CSS 文件,src/css/style.css 改了也不会触发刷新。
** 是通配符关键,不是可选项;多个后缀之间必须用英文逗号 + 空格分隔,否则某些 shell 下解析失败。
- 正确写法:
"**/*.html, **/*.css, **/*.js"(注意空格) - 错误写法:
"*.html,*.css"(无空格)、"*.html, *.css"(只有一级通配) - 若项目构建产物在
dist/目录,应监听:"dist/**/*.html, dist/**/*.css" - 路径含中文?部分系统会卡住监听,建议先移出中文路径再试
手机同步预览必须加 --host 0.0.0.0,否则连不上
默认 browser-sync start --server 绑定的是 127.0.0.1,仅本机可访问。手机要同步,必须显式放开监听地址。
- 启动命令加:
--host 0.0.0.0 --port 3000(端口可换,如--port 4000) - 终端会额外输出
External: http://192.168.x.x:3000,手机浏览器访问这个地址 - 确保手机和电脑在同一局域网:手机连的是公司 Wi-Fi,不是自己开的 5G 热点
- 公司防火墙或 macOS 隐私设置可能拦截端口,打不开时优先换端口,其次检查系统防火墙放行
Markdown 实时预览的“自动刷新”是伪实时,首次手动预览不可跳过
MarkdownPreview 插件不生成服务,也不起 HTTP 服务器,它的“自动刷新”本质是向已打开的浏览器标签页发 reload 指令——前提是那个标签页存在且 URL 合法。
- 必须先按
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser→ 回车(一次都不能少) - 之后保持该浏览器标签页打开,且地址是
file://或http://127.0.0.1开头(http://localhost有时因端口冲突失败) - 配置项
"enable_autoreload": true在 2026 年起的新版中已被废弃,强行写入会导致 Sublime 保存时卡顿甚至崩溃 - 右下角状态栏必须显示
Markdown(不是 Plain text、不是 Markdown GFM),未保存的untitled文件永远无法触发
最容易被忽略的是:所有“自动同步”都建立在「服务跑起来 + 浏览器连对地址 + 插件行为链没断」这三者同时成立的基础上。少一个环节,表现就是“改了没反应”,但错误不会报出来,只会静默失效。











