VSCode中Live Sass Compiler插件报错90%是因sass命令缺失、BOM编码或路径配置问题；需验证sass --version、清除BOM、配置includeItems、避免savePath冲突，并推荐用tasks.json调用sass --watch。
VSCode 里装 Live Sass Compiler 插件报错，90% 不是插件本身坏了，而是它启动时找不到 sass 命令、或被编码/BOM/路径配置卡住——插件不报具体错误，只静默失败。
确认 sass CLI 是否真可用
Live Sass Compiler 默认会 fallback 到系统级 sass 命令（尤其在处理 @use、@forward 或生成 source map 时），不是光装插件就完事。
- 打开 VSCode 终端（
Ctrl+`），运行sass --version - 若提示
command not found：执行npm install -g sass（别用node-sass，它已废弃） - macOS/Linux 用户装完必须重启 VSCode；Windows 用户若用 pnpm/yarn，需确认
$HOME/.local/share/pnpm/bin或$HOME/.yarn/bin已加进PATH
_partial.scss 文件不编译？检查 includeItems 配置
Sass 规范规定：以 _ 开头的文件（如 _mixins.scss）默认不作为入口，Live Sass Compiler 严格遵守这点——这不是 bug，是设计行为。
- 必须在项目根目录的
.vscode/settings.json中显式声明："liveSassCompile.settings.includeItems": ["**/_*.scss"] - 别写成
"**/_mixins.scss"这种固定路径，否则新增的_variables.scss仍会被跳过 - 删掉
liveSassCompile.settings.savePath字段（如果存在），它会覆盖formats里的savePath，导致路径错乱
保存没反应？先盯右下角状态栏和文件编码
插件无日志、无弹窗、无报错，但就是不编译——大概率卡在这两个地方。
- 右下角状态栏显示的不是你当前项目名？说明 VSCode 没识别到工作区根目录。关掉多文件夹工作区，只打开项目最外层文件夹
- 右下角编码显示
UTF-8 with BOM？立刻点它 →Save with Encoding→ 选UTF-8。BOM 头会让插件解析器直接退出，不报错也不干活 - 状态栏没出现
Compiling SASS提示？按Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入Live Sass: Watch My Sass手动触发一次，看是否能启动
替代方案：tasks.json + sass --watch 更稳
插件黑盒逻辑太多，中大型项目建议绕过它，直接调用你本地装好的 sass 命令——行为可预期、支持模块语法、还能无缝接入 CI。
- 确保
sass --version在终端中可用 - 在项目根目录建
.vscode/tasks.json，核心字段含："type": "shell"、"command": "sass"、"args": ["--watch", "src/scss/:dist/css/"] - 注意路径分隔符：Windows 用反斜杠
\，macOS/Linux 用正斜杠/；watch 路径末尾不要漏冒号:
真正麻烦的从来不是“怎么配”，而是 sass --version 看似成功、实际被 PATH 缓存骗了，或者文件编码带 BOM 却没意识到——这些点不手动验证，所有配置都白搭。
