VSCode中Sass保存不生成CSS，主因是sass命令未安装、下划线partial文件未在includeItems中配置、文件编码含BOM或工作区路径错误；需依次验证sass --version、添加"liveSassCompile.settings.includeItems": ["*/_.scss"]、保存为UTF-8无BOM、确保正确工作区根目录。
VSCode 里 Sass 保存后没生成 CSS，90% 不是插件坏了，而是 sass 命令根本没装好、文件被静默跳过，或路径/编码配置错了一处。
确认 sass 命令是否可用（最常卡住的环节）
Live Sass Compiler 插件虽自带轻量引擎，但很多行为（如 includeItems 解析、watch fallback）仍依赖系统级 sass 命令。不验证这一步，后面全白配。
- 在 VSCode 终端（
Terminal → New Terminal）中运行sass --version - 若报
command not found，执行npm install -g sass（别用node-sass，它已废弃，不支持@use） - macOS/Linux 用户装完必须重启 VSCode；pnpm 用户检查
$PATH是否包含全局 bin 路径
检查 includeItems 是否漏掉下划线文件
Sass 规范规定：以 _ 开头的文件（如 _mixins.scss、_variables.scss）是 partial，不参与直接编译——插件默认遵守该规则，不会主动编译它们，也不会报错，只会静默跳过。
- 在项目根目录的
.vscode/settings.json中，必须显式添加"liveSassCompile.settings.includeItems": ["**/_*.scss"] - 如果只希望编译特定几个 partial，可写成
["**/_mixins.scss", "**/_layout.scss"] - 别依赖默认值；不加这一项，改了
_header.scss保存后，style.css就永远不会更新
验证文件编码和工作区根目录
Live Sass Compiler 对编码和工作区结构非常敏感，两个条件任一不满足，就静默失效，连提示都没有。
立即学习“前端免费学习笔记（深入）”；
- 右下角点击当前编码（如显示
UTF-8 with BOM），选Save with Encoding → UTF-8（注意：不是带 BOM 的那个） - 检查左下角状态栏是否显示你预期的项目根路径；多文件夹工作区下，插件只监听第一个文件夹
- 确保
.scss文件在已打开的工作区目录内，不在node_modules或被watchExclusions拦截的路径中
别让 sass --watch 和插件同时写同一个 CSS 文件
如果你在终端手动跑了 sass --watch src/scss:dist/css，又启用了 Live Sass Compiler，两个进程会争抢写入同一份 .css 文件——Windows 下极易写空、损坏或内容错乱，表现为 CSS 文件突然变 0 字节或样式丢失。
- 开发时优先关掉终端里的
sass --watch，插件响应更快、更轻量 - 若必须共存（比如 CI 需要 CLI 输出），请确保输出路径完全隔离，例如插件输出到
/css/，CLI 输出到/dist/css/ - Live Sass Compiler 不支持
@use/@forward，如果你的 SCSS 已全面迁移到新模块语法，它压根编译不过，只能切回 CLI 或构建工具
真正难调试的从来不是配置本身，而是那些不报错、不提示、只是“没反应”的静默失败点——BOM 编码、partial 文件遗漏、工作区路径错位、CLI 命令未就绪，每一个都足以让整个流程停摆。动手前先盯住终端和右下角状态栏，比反复重装插件有用十倍。
