View in Browser 的 url_map 配置需启用内置服务器，键为项目根目录起的相对路径（正斜杠），值为对应 URL 路径，如 {"url_map": {"/": "my-site/"}}；file:// 协议下无效。
View in Browser 的 url_map 配置怎么写才生效
插件本身不自动把 $file 转成 http://localhost:8080/xxx.html，得靠 url_map 手动配路径映射。它只在启用内置服务器（View in Browser: Start Server）后起作用，file:// 协议下完全忽略。
常见错误是直接填本地绝对路径，比如 "C:\project\index.html" —— 这不行，url_map 只接受「从项目根目录开始的相对路径」到 URL 路径的映射。
- 必须用正斜杠
/，不能用反斜杠（Windows 也一样） - 键是文件系统中相对于当前 Sublime 工作目录（即
Project → Open Folder的根）的路径，值是对应访问时的 URL 路径 - 例如项目结构为
my-site/index.html，想通过http://localhost:8080/访问，则配置：{"url_map": {"/": "my-site/"}} - 如果打开的是
my-site/css/style.css，想让浏览器请求http://localhost:8080/css/style.css，就写：{"url_map": {"/css/style.css": "my-site/css/style.css"}}
browser_path 和 browser 两个配置项有什么区别
browser_path 指向具体可执行文件（如 Chrome 的 .exe 或 macOS 上的 Contents/MacOS/Google Chrome），优先级最高；browser 是字符串标识（如 "chrome"、"firefox"），仅当没设 browser_path 时才生效，且依赖系统能否识别该命令名。
容易踩的坑：
- Windows 下写错反斜杠：填
"C:Program FilesGoogleChromeApplicationchrome.exe"会静默失败，必须双写"C:\Program Files\Google\Chrome\Application\chrome.exe" - macOS 填
/Applications/Google Chrome.app不行，必须填完整可执行路径/Applications/Google Chrome.app/Contents/MacOS/Google Chrome - Linux 用户若用桌面文件（如
google-chrome.desktop）代替真实二进制路径，也会打不开
为什么改了 url_map 还是 404？检查这三点
映射失效往往不是配置写错了，而是服务没跑在预期路径上。
- 确认已执行
View in Browser: Start Server（右键菜单或命令面板），不是单纯点View in Browser—— 后者走 file://，根本不读url_map - 看终端输出：启动服务器时，Sublime 底部状态栏会显示类似
Server started on http://localhost:8080，如果没这条，说明服务根本没起来 - 检查工作目录：如果没用
Project → Open Folder，而是单个文件打开，url_map的键将基于该文件所在目录计算，极易错位；建议始终以文件夹形式打开项目
不配 url_map 就没法预览带相对路径的资源？
可以，但得换思路。如果 HTML 里引用了 ./css/main.css 或 ../js/app.js，而你又不想配 url_map，最稳的办法是让整个项目根目录就是服务器根目录。
操作很简单：
- 用
Project → Add Folder to Project…把含index.html的最外层文件夹加进来 - 确保这个文件夹里有
index.html、css/、js/等子目录 - 再执行
View in Browser: Start Server，默认就以该文件夹为根提供服务，所有相对路径自然能命中
这时候 url_map 其实可以完全不填——除非你要做路由重写或跨目录映射，否则多数前端小项目真用不上它。
