90%的“保存不编译”问题源于sass命令未安装或VSCode找不到它；须在系统原生命令行验证sass --version，全局安装npm install -g sass，重启VSCode，并确保UTF-8无BOM编码、includeItems显式包含下划线文件、tasks.json路径格式正确。
sass 命令没装好，或者 VSCode 找不到它——这是 90% 的“保存不编译”问题的根源。其他配置再对，引擎都启动不了。
确认 sass 命令是否可用
Live Sass Compiler 插件和 tasks.json 都依赖系统级 sass（Dart Sass），不是已废弃的 node-sass。
- 在 VSCode 终端（
Terminal → New Terminal）运行sass --version；如果报command not found，说明未安装或 PATH 未生效 - 执行
npm install -g sass（推荐）；pnpm用户需确认全局 bin 在$PATH中，必要时手动添加 - macOS/Linux 装完必须重启 VSCode，否则终端 PATH 不刷新；Windows 用户注意检查
C:\Users\{user}\AppData\Roaming\npm是否在环境变量里
Live Sass Compiler 配置必须显式包含下划线文件
插件默认跳过所有 _*.scss 文件（如 _variables.scss），这不是 bug，是 Sass 规范行为。不加 includeItems，partial 文件根本不会参与编译。
- 在项目根目录创建或编辑
.vscode/settings.json - 必须写入
"liveSassCompile.settings.includeItems": ["**/_*.scss"]，路径用双星号匹配任意层级 -
"liveSassCompile.settings.savePath"是无效字段，要用"formats"里的savePath（如"/css/"表示输出到项目根下的css/目录） - 右下角点击
Watch Sass启动监听；若无反应，先点右下角编码 →Save with Encoding → UTF-8（排除 BOM 干扰）
tasks.json 中路径写法决定 CSS 输出位置
用 sass --watch 时，路径格式直接影响生成逻辑。写错分隔符或模式，会导致监听失效或文件乱放。
立即学习“前端免费学习笔记（深入）”；
- 推荐目录映射模式：
"sass", "--watch", "src/scss/:dist/css/"（注意冒号前后无空格，统一用正斜杠/，Windows 也别用反斜杠） - 单文件绑定模式（如
"src/scss/main.scss:dist/css/main.css"）只监听一个入口，适合简单项目 - 加
--source-map才生成.css.map；--no-source-map会禁用，调试时看不到原始行号 - 别同时运行
tasks.json和 Live Sass Compiler，两个进程抢写同一份.css，尤其 Windows 下容易卡死或覆盖
最容易被忽略的是：文件编码为 UTF-8 without BOM + @charset "UTF-8" 必须是首行首字符 + sass 命令真实可用——三者缺一，中文变量、注释或路径含中文时就会静默失败，连错误都不报。
