Sublime Text 中 Sass 命令报错因未继承 shell PATH，需手动配置 sass_path；编译路径错误需设 output_dir；变量未加载需检查 include_paths 和 @use/@import 规则；Autoprefixer 需额外集成 PostCSS。
为什么 sass 命令在终端能跑，Sublime 里却报 “command not found”
Sublime Text 默认不继承 shell 的 PATH 环境变量，尤其在 macOS 或 Linux 图形界面启动时，它看不到你通过 zshrc 或 bash_profile 配的 sass、lessc 路径。Windows 上则常因 Node.js 安装路径没进系统 PATH 或用了 nvm 导致切换版本后失效。
- 先在终端运行
which sass（macOS/Linux）或where sass（Windows），拿到绝对路径，比如/usr/local/bin/sass或C:\Users\Me\AppData\Roaming\npm\sass.cmd - 打开 Sublime → Preferences → Package Settings → Sass → Settings（如果是 Less，则找 Less → Settings）
- 在右侧用户设置中写入：
"sass_path": "/usr/local/bin/sass"
（注意不是sass --watch，只是可执行文件路径） - macOS 上若用 Homebrew 安装了 Ruby Sass（已弃用），路径可能是
/usr/local/bin/sass；如用 Dart Sass，路径大概率是/opt/homebrew/bin/sass或/usr/local/bin/sass
保存即编译时，CSS 文件总生成在错误目录
默认行为是把 .scss 编译到同级目录，但很多人习惯把源码放 src/、输出放 dist/css/。插件本身不自动识别项目结构，得靠配置映射。
- 在
Sass.sublime-settings中加"output_dir"，比如："output_dir": "dist/css"
—— 这会让所有.scss编译结果都丢进该相对路径 - 如果要按源文件层级保留嵌套结构（例如
src/scss/components/button.scss→dist/css/components/button.css），必须启用"output_style": "nested"并确保"save_on_build": true，同时确认插件支持该特性（原生 Sass 插件不支持，需换用SublimeOnSaveBuild+ 自定义 build system） - Less 插件对
output_dir支持更弱，经常忽略它；建议直接用Less2CSS插件，并在它的设置里填"lessc_args": ["--include-path=src/less", "--source-map"]来控制输入上下文
修改变量后保存，CSS 没更新或报错说 “undefined variable”
这不是编译失败，而是 Sass 解析器没找到被依赖的 _variables.scss。Sublime 插件默认只编译当前打开的文件，不会自动 resolve @import 或 @use 的路径。
- 确保主文件（如
main.scss）开头有@import "variables";或@use "variables";，且variables.scss和它在同一目录，或在include_paths列表里 - 在设置中加
"include_paths"数组，例如："include_paths": ["src/scss/base", "node_modules/bootstrap/scss"]
- Dart Sass 要求
@use必须用全路径（含扩展名），而@import可省略；插件若调用的是旧版 Ruby Sass，@use直接报错 —— 此时得确认sass_path指向的是 Dart Sass - 缓存问题：某些插件会缓存 import 树，改完
_variables.scss后，先关掉再重开main.scss，或手动触发一次完整构建（Ctrl+B/Cmd+B）
想用 Autoprefixer 却发现 CSS 里没加浏览器前缀
Sublime 的 Sass/Less 插件只负责编译，不集成 PostCSS。所谓“内置 Autoprefixer”是误解，那是某些构建工具（如 Gulp、Vite）做的事。
- 别指望
Sass插件设置里加个"autoprefixer": true就生效 —— 它压根不读这个字段 - 可行方案只有两个：一是用
SublimeOnSaveBuild插件，配一个调用postcss的 build system；二是放弃 Sublime 实时编译，改用命令行sass --watch+postcss --watch组合 - 如果硬要在 Sublime 里链式处理，build system 示例（保存为
SCSS + PostCSS.sublime-build）：{ "cmd": ["sass", "--style=expanded", "$file", "${file_path}/${file_base_name}.css", "&&", "postcss", "${file_path}/${file_base_name}.css", "-o", "${file_path}/${file_base_name}.css"], "selector": "source.scss" }注意&&在 Windows 下可能失效，得改用批处理或 PowerShell 封装
真正麻烦的从来不是配路径，而是搞清哪个环节负责哪段逻辑：Sass 解析变量、PostCSS 加前缀、文件定位靠路径配置、环境变量靠 shell 初始化——漏掉任何一环，都会让你盯着空白 CSS 文件发呆。
