sublime text 本身不生成 source map，能否调试取决于 dart sass 是否输出、浏览器能否读到，以及路径是否对得上——三者缺一不可；dart sass 1.23.0+ 默认开启 --sourcemap，但仅当显式指定输出文件路径（如 sass input.scss output.css）时才生成 .css.map 文件，若仅用 sass input.scss 则输出至 stdout 且不生成 map；.css 文件末尾必须含 /# sourcemappingurl=xxx.css.map / 注释，.map 文件须与 .css 同目录且可通过 http 访问（file:// 协议下因安全策略失效），sublime 构建系统需正确配置 cmd、working_dir 和绝对路径以确保 sass 命令可执行并生成有效映射。
Sublime Text 本身不生成 source map，能否调试取决于 Dart Sass 是否输出、浏览器能否读到，以及路径是否对得上——三者缺一不可。
确认 Dart Sass 是否默认输出 source map
Dart Sass 1.23.0+ 默认开启 --sourcemap，但只在命令行显式指定输出 CSS 文件时才写入 .css.map 文件（例如 sass input.scss output.css）。如果用 --watch 或仅传入单个文件名（如 sass input.scss），它会把 CSS 打印到 stdout，不落地、也不生成 map。
- 正确触发 source map 的调用方式必须含明确的输出路径：
sass src/main.scss dist/css/main.css - 若想强制关闭，加
--no-sourcemap；想改名或指定 map 路径，用--sourcemap=inline或--sourcemap=dist/css/main.css.map - 注意：Dart Sass 不支持
--source-map（带短横线）这种旧写法，会报错Unknown option --source-map
确保 .css 文件里有 sourceMappingURL 注释
生成的 main.css 文件末尾必须包含形如 /*# sourceMappingURL=main.css.map */ 的注释，否则浏览器不会加载 map。这个注释由 Dart Sass 自动写入，但前提是：
- 输出路径是完整文件路径（不能是 stdout）
- 没加
--no-sourcemap - 没用
--style=compressed以外的压缩模式干扰注释位置（Dart Sass 在压缩模式下仍会保留该注释）
常见错误：构建系统里写成 "cmd": ["sass", "$file"] —— 这等价于 sass input.scss，只输出 CSS 内容到 Sublime 控制台，不生成任何文件，自然也没有 sourceMappingURL 注释和 .map 文件。
让浏览器能访问到 .css.map 文件
浏览器读取 .css.map 的前提是它可通过 HTTP 被访问到，且路径与 sourceMappingURL 中声明的一致。这意味着：
-
.map文件必须和.css文件放在同一目录下（例如dist/css/main.css和dist/css/main.css.map） - 本地开发时若用 file:// 协议打开 HTML，现代浏览器（Chrome/Firefox）会因安全策略拒绝加载
.map文件——必须起一个本地服务（如npx http-server或 Live Server 插件） - 如果构建系统把 CSS 输出到
dist/css/，但sourceMappingURL写成../maps/main.css.map，而实际 map 文件不在那里，调试就失效
验证方法：在浏览器开发者工具 Network 标签页中刷新页面，搜索 main.css.map，看状态码是不是 200。404 就说明路径不对或文件根本没生成。
Sublime 构建系统里怎么配才真正生效
别依赖插件自动猜路径。用自定义 .sublime-build 文件最可控，例如保存为 Packages/User/Sass-debug.sublime-build：
{
"cmd": ["sass", "--sourcemap", "$file", "$file_path/../dist/css/$file_base_name.css"],
"selector": "source.scss",
"shell": true,
"working_dir": "$file_path",
"file_regex": "^(.*?):(\d+):(\d+):(.*)$"
}
关键点：
-
"--sourcemap"显式启用（虽是默认，但写明更稳妥） - 第二个参数是输入（
$file），第三个是输出（$file_path/../dist/css/...），顺序不能反 -
working_dir设为$file_path，确保@use或@import能相对定位依赖文件 - 不要在 cmd 里写
sass --watch——它会阻塞 Sublime 构建流程，保存后无响应
容易被忽略的是：Sublime 启动时 PATH 可能和终端不同，尤其 macOS 使用 zsh 的用户。即使终端里 sass --version 正常，Sublime 也可能找不到 sass。此时必须用 which sass 拿到绝对路径（如 /opt/homebrew/bin/sass），并在 cmd 中直接写死，而不是依赖环境变量查找。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
