Sublime Text预览失败主因是配置错误、路径含空格未转义及场景混淆；必须改Settings-User而非Default，default_browser值限小写白名单，Preview URLs路径末尾须带/，浏览器路径用正斜杠或双反斜杠。
Sublime Text 本身不内置“默认浏览器”概念，所有预览行为都依赖插件或自定义 Build System；改错配置文件、路径含空格未转义、没区分 testing/production 场景，是 90% 预览失败的根源。
SideBarEnhancements 的 default_browser 不生效？先确认插件已启用且配置在 User 文件
很多人在 Settings-Default 里改 "default_browser": "chrome"，结果重启后无效——因为 Default 是只读模板，升级必被覆盖。必须改 Settings-User（菜单 Preferences → Package Settings → Side Bar → Settings-User），内容仅需一行 JSON：
{ "default_browser": "chrome" }
支持值严格限定为：chrome、firefox、canary、chromium、opera、safari、ie（注意不是可执行文件名，也不是路径）；填 "Google Chrome" 或 "C:\Program Files\..." 会静默失效。
用 side_bar_open_in_browser 快捷键打开 localhost 而非 file://？必须配 Preview URLs
直接打开 HTML 文件走的是 file:/// 协议，PHP/JS 无法加载、AJAX 404、本地服务器功能全废。要映射到 http://localhost:8000/，得靠 SideBarEnhancements 的项目级 URL 映射：
- 右键侧边栏任意文件 →
Project → Edit Preview URLs - 填入项目磁盘路径与对应 URL，例如：
{ "D:/myproject/": { "url_testing": "http://localhost:8000/" } } - 路径末尾必须带
/，否则匹配失败；url_testing和url_production可同时存在，调用时用"type": "testing"指定 - 快捷键绑定中
"type": "testing"必须和这里 key 对应，否则 fallback 到file://
Open In Browser 插件里填浏览器路径，Windows 下空格和括号怎么处理？
像 C:Program Files (x86)GoogleChromeApplicationchrome.exe 这种路径，直接粘贴进 Open In Browser 的用户设置会报错或打不开。正确做法是：
- 路径中所有空格和括号不用额外转义，但必须用正斜杠
/或双反斜杠\（单反斜杠是 JSON 转义符，会导致解析失败） - 推荐写法：
"chrome": "C:/Program Files (x86)/Google/Chrome/Application/chrome.exe" - 如果路径含中文，确保 Sublime Text 启动时编码环境支持 UTF-8（一般默认满足，但某些老旧 Windows 系统需检查系统区域设置）
- 验证是否生效：按
Alt+Shift+O，若列表中出现 “Chrome” 且点击后能打开，说明路径识别成功
Build System 方式调浏览器，${file} 和 $file 有什么区别？
在 .sublime-build 文件里，变量写法直接影响路径生成逻辑：
-
${file}（带花括号）是 Sublime 原生变量，会被替换成完整绝对路径，如D:siteindex.html -
$file（无花括号）是 Shell 环境变量，在 Windows 上多数情况也能工作，但跨平台兼容性差，macOS/Linux 下可能为空或报错 - Windows 下用
cmd /c start "" "${file}"最稳；macOS 用open "${file}"；Linux 用xdg-open "${file}" - 别在 Build System 里硬编码浏览器路径——它绕过系统关联，但丧失对 URL 映射、localhost 代理等高级能力的支持
真正麻烦的从来不是选哪个插件，而是路径层级嵌套时，Preview URLs 的磁盘路径必须精确到目录末尾斜杠、default_browser 的字符串必须小写且在白名单内、浏览器路径里的斜杠方向稍有偏差就静默失败——这些细节不试三次以上根本记不住。
