Atom本身不内置Sass编译能力，必须安装atom-build-sass或sass-autocompile插件，并全局安装Dart Sass（npm install -g sass），禁用已废弃的node-sass；需配置executablePath、outputPath、--style和--source-map等参数，注意路径无中文空格、文件保存后才触发编译。
Atom 本身不内置 Sass 编译能力，必须靠插件 + 外部 CLI 工具协同工作；sass（Dart Sass）是当前唯一推荐的编译器，node-sass 已废弃且不再维护。
装对编译器：用 sass，别碰 node-sass
插件只是调命令的“遥控器”，真正干活的是全局安装的 sass CLI。macOS / Windows 都要先在终端运行：
npm install -g sass
验证是否成功：
sass --version
输出应类似 1.77.2（Dart Sass 版本）。如果报错或显示 node-sass 版本，说明装错了——卸载它：
立即学习“前端免费学习笔记（深入）”；
npm uninstall -g node-sass-
npm uninstall -g sass（再重装一次上面的sass）
macOS 用户特别注意：zsh + Homebrew 安装的 Node 可能导致 Atom 找不到全局 sass 命令，此时需在插件设置里手动填 executablePath，比如 /opt/homebrew/bin/sass 或 which sass 的实际路径。
选对插件：atom-build-sass 或 sass-autocompile
不要装 atom-sass（老旧、不维护、只支持 Ruby Sass）或 language-sass（它只管语法高亮，不编译）。
atom-build-sass 更轻量，适合习惯用快捷键触发编译的人；sass-autocompile 支持保存即编译（watch 模式），但配置项更多、容易卡住。
安装后必须重启 Atom，否则插件不会加载环境变量。
关键配置项（以 sass-autocompile 为例）：
-
outputPath：默认输出到同目录，想输出到css/文件夹？填../css/$1.css（$1是文件名不含扩展名） -
style：选compressed还是expanded，影响生成 CSS 的可读性与体积 -
sourceMap：开发阶段建议开启，上线前关掉能提速
常见报错：“EROFS: read-only file system”
错误信息里带 EROFS 和 .sass-cache，说明 Sass 尝试往只读目录写缓存（比如某些挂载的网络盘、iCloud 同步目录、或 macOS 的受保护系统路径）。
解决方法只有两个：
- 把项目移到本地普通路径下（如
~/Projects/myapp） - 加
--no-cache参数：在插件的arguments字段末尾加上该选项（例如：--no-cache --style compressed）
别试图改权限或 sudo 运行 Atom——这会引入更大风险，且不治本。
为什么改了 .scss 文件没自动编译？
不是插件坏了，大概率是以下任一原因：
- 文件未保存：多数插件只监听“保存事件”，Ctrl+S / Cmd+S 必须按下去
- 文件没被识别为 SCSS：右下角状态栏检查是否显示
SCSS，不是CSS或Plain Text；若不对，点一下状态栏 → Select Language →SCSS - 插件未启用：Settings → Packages → 搜索插件名 → 确认 Enabled 开关是蓝色
- 路径含中文或空格：某些旧版插件解析失败，尽量用英文路径
最隐蔽的问题是：Atom 启动时插件还没加载完，而你已经保存了文件——这时第一次保存不会触发编译，第二次才会。重启 Atom 后首次保存务必等几秒再按 Ctrl+S。
