Sass自动编译配置实现CSS实时预览

先别急着怀疑插件坏了。Live Sass Compiler 保存后毫无反应，编译输出完全没动静，多半是卡在三个硬条件上：文件名不能以 _ 开头（除非配置了 includeItems）、文件必须在已打开的项目根目录下、编码必须是 UTF-8（不是 UTF-8 with BOM）。这三个条件缺一不可，否则插件静默失败，连个错误提示都不给。

Live Sass Compiler 保存没反应？先检查这三个硬条件

插件装上了不代表就能用。来看具体怎么排查：

• 右下角状态栏确认显示的是你期望的项目根路径，而不是"未打开文件夹"或某个子目录。
• 右下角点编码 → Save with Encoding → 选 UTF-8（注意别选成 UTF-8 with BOM）。
• _variables.scss、_mixins.scss 这类 partial 文件必须显式加进 includeItems，比如 "**/_*.scss" 或者更精确的 "src/scss/_*.scss"。

vscode/settings.json 必配的三个字段

只改 savePath 远远不够，漏掉任意一个字段，CSS 就可能生成到错误位置、没有 source map，甚至根本没有输出。

• liveSassCompile.settings.formats：数组结构，每个对象必须包含 format（expanded 或 compressed）、extensionName（固定 ".css"）和 savePath（相对项目根的路径，比如 "/dist/css/"，开头带 / 表示从根开始）。
• liveSassCompile.settings.generateMap：设为 true 才会生成 .css.map，否则调试时看不到原始 SCSS 行号。
• liveSassCompile.settings.includeItems：不写这个字段，所有 _ 开头的文件全部被忽略——哪怕它们被 @use 引入了也没用。

sass --watch 用 tasks.json 调用更稳

插件有时会有隐藏行为，改用 tasks.json 直接调用 Dart Sass CLI，路径、格式、source map 全由你掌控，天然支持 @use 和模块系统。

• 确保 sass --version 在 VSCode 终端能正常执行；不行就重装：npm install -g sass，macOS/Linux 用户装完必须重启 VSCode。
• args 中的路径用正斜杠 /，避免 Windows 下反斜杠解析失败，例如："--watch", "src/scss/:dist/css/"。
• 加 --source-map 参数才生成 map；不加则默认不生成（--no-source-map 其实是多余的）。
• 别同时运行 Live Sass Compiler 和 sass --watch，两个进程会抢写同一个 .css 文件，导致内容错乱。

实时预览 ≠ 只编译，还得让浏览器刷新

Live Sass Compiler 本身只管生成 CSS，不刷新页面。浏览器要想感知变化，还需要做两件事：

• HTML 中引用的路径必须和 savePath 完全一致。比如生成到 dist/css/style.css，HTML 里就得写 。
• 推荐搭配 Live Server 插件：右键 HTML → Open with Live Server，它监听整个目录，CSS 一更新页面就自动刷新。
• 如果用了 sass --watch + Live Server，只要 CSS 路径正确，Live Server 就能捕获到变更——它默认不监听 node_modules，但也不会误刷其他无关文件。

真正卡住的从来不是配置项本身，而是 sass 命令根本没装好、VSCode 终端 PATH 没刷新、或者 _partial.scss 被悄悄跳过——这些点不手动验证，所有设置都只是摆设。