scss文件无语法高亮因未关联sass语法,需右键设为sass或安装syntax highlighting for sass;编译报错“command not found: sass”是因未安装dart sass cli或path未配置;build system需正确设置working_dir和路径变量;@import失效是dart sass禁用旧导入,应改用@use或加--legacy-flag参数。

SCSS 文件打开后没有语法高亮
Sublime 默认不识别 .scss 文件,会当成纯文本或 CSS 处理,导致关键词、嵌套、变量全无颜色区分。这不是插件冲突,是文件关联没配好。
- 右键编辑区 → “Set Syntax” → “Open all with current extension as...” → “Sass”(注意选的是
Sass,不是CSS) - 如果列表里没有
Sass,说明没装对应语法包——直接装Package Control,搜Syntax Highlighting for Sass,装完重启 Sublime - 装完后,
.scss文件仍显示为 CSS?检查右下角状态栏是否显示Sass;若显示CSS,点它手动切过去
SCSS 编译报错:“command not found: sass”
Sublime 本身不编译 SCSS,得靠外部命令行工具。报这个错,说明系统里没装 sass CLI,或者路径没进环境变量。
- 先在终端运行
sass --version,确认是否安装。没装就用npm install -g sass(推荐 Dart Sass) - Mac/Linux 用户如果用 zsh,装完可能要手动把 npm 全局 bin 路径加进
$PATH,否则 Sublime 启动时读不到 - Windows 用户注意:别用旧版
ruby-sass(已废弃),也别只装 Node.js 不装sass包——装了 Node.js ≠ 自带sass命令
用 Build System 编译 SCSS 却没输出 CSS 文件
Sublime 的 Build System 只负责调命令,不自动处理路径、监听或错误提示。常见问题是配置写死了输入/输出路径,或没设 working_dir。
- 建新 Build System(Tools → Build System → New Build System),贴入:
{
"cmd": ["sass", "--update", "$file:$file_path/$file_base.css", "--style=expanded"],
"selector": "source.scss",
"working_dir": "$file_path"
}
$file 是当前 SCSS 路径,$file_path/$file_base.css 表示同目录生成同名 CSS——别漏掉 $file_path/,否则可能输出到 Sublime 安装目录SCSS.sublime-build,再右键 → “Build With” → “SCSS”
File to read not found,大概率是 working_dir 没设,导致 sass 在错误路径下找文件SCSS 中 @import 报错或变量不生效
这是 Dart Sass 的模块系统升级导致的典型问题。老项目用 @import,新版本默认禁用,必须显式开启或改用 @use。
立即学习“前端免费学习笔记(深入)”;
- Build System 的
cmd加上--legacy-flag参数(仅限临时兼容):["sass", "--legacy-flag", "--update", ...] - 更稳妥的做法:把
@import "vars"改成@use "vars",并用vars.$color访问变量——Dart Sass 不再全局注入@import的内容 - 如果用了第三方库(如 Bourbon、Compass),它们基本不维护了,换用
@forward+@use重写,或切回 Node Sass(但已停止维护)










