Sublime Text 中 Sass 编译不生效，主因是误装语法高亮插件（Sass）而非编译插件（SCSS 或 Easy SCSS），或构建系统未正确配置为对应插件选项；需确认 sass 命令可用、路径无中文空格、source-map 参数正确，并通过控制台排查静默错误。
Sublime Text 里 Sass 编译不生效，大概率是没装对插件或没配对构建系统
Sublime Text 本身不带 Sass 编译能力，必须靠插件 + 正确的构建配置。很多人装了 Package Control 后搜 “Sass”，随手点了 Sass（语法高亮插件）就以为搞定了——它只负责让 .scss 文件有颜色，完全不编译。
真正干活的是 SCSS 插件（注意大小写和拼写），或者更稳妥的 Easy SCSS。前者依赖系统已安装的 sass 命令行工具；后者自带轻量编译器，适合不想装 Ruby 或 Node 的人。
- 确认是否已全局安装
sass：终端运行sass --version，输出类似1.77.2才算到位（Dart Sass 是当前唯一推荐版本） - 如果用
SCSS插件但sass命令找不到，Sublime 会静默失败，连错误提示都不给 -
Easy SCSS默认不监听保存，得手动右键 →Easy SCSS: Toggle Auto Compile
构建系统（Build System）选错，.scss 文件一保存就报错 Unable to find target
这个错误不是 Sass 问题，是 Sublime 没法把当前文件映射到有效的构建流程。常见原因是：用了默认的 Python 构建系统，或者自定义构建里路径写死了 ./css/ 但项目根本没有这个目录。
正确做法是用插件自带的构建定义，而不是手写 JSON。比如装了 SCSS 插件后，菜单栏 Tools → Build System → SCSS 必须被勾选；装了 Easy SCSS 就选 Easy SCSS。
立即学习“前端免费学习笔记（深入）”；
- 不要手动创建
Tools → Build System → New Build System…写cmd，容易漏掉shell或path配置 - 如果项目结构是
src/scss/main.scss → dist/css/main.css，确保main.scss文件里有正确的@import路径，且没有中文或空格在路径中 - Windows 用户要注意：
sass命令在 PowerShell 和 CMD 下行为略有差异，建议统一用 CMD 测试
编译出来的 CSS 没更新，或者生成了 .css.map 却没效果
这不是编译失败，而是输出配置没对上开发需求。Dart Sass 默认开启 source map，但浏览器要读到它，得满足两个条件：CSS 文件里有 sourceMappingURL=xxx.css.map 注释，且该 .map 文件跟 CSS 在同一目录下可访问。
很多人的 sass 构建命令漏了 --source-map 参数，或者用了 --no-source-map 却不知道自己写了它。
- 推荐构建命令（以
SCSS插件为例）：sass --update --sourcemap=auto --style=expanded $file:$file_path/$file_base.css -
--update表示只编译变更的文件，省时间；--style=expanded避免压缩后难调试 - 如果项目用 Webpack/Vite 等现代工具链，Sublime 编译纯属备用方案，别指望它跟 dev server 实时同步
Mac / Windows 下路径权限或环境变量导致构建卡住没反应
尤其 Mac M 系列用户，用 Homebrew 装的 sass 可能装在 /opt/homebrew/bin/sass，而 Sublime 默认 shell 环境压根没加载这个路径。结果就是构建时找不到命令，界面无提示，只有控制台（Ctrl+`）里闪一下就没了。
Windows 则常见于 Node 版 Sass 被装在用户目录下，但 Sublime 启动方式（比如从桌面图标点开）不继承系统的 %PATH%。
- Mac 解决方法：在 Sublime 的菜单
Sublime Text → Preferences → Settings – Syntax Specific里加一行："shell_cmd": "PATH=/opt/homebrew/bin:$PATH sass --update $file:$file_path/$file_base.css" - Windows 推荐改用
Easy SCSS，它不依赖外部命令，避免 PATH 问题 - 所有平台都建议打开 Sublime 控制台（
Ctrl+`），保存文件时看有没有报错，比盲猜快得多
最麻烦的不是配置多，而是错误被吞掉——Sublime 不像 VS Code 那样弹红框，它只在后台静默失败。盯住控制台，比反复重装插件有用十倍。
