Live Sass Compiler未自动编译Sass/SCSS文件，需依次检查扩展启用状态、文件命名规范（非下划线开头且后缀为.scss/.sass）、配置settings.json启用自动编译、手动触发Watch命令并查看输出面板，以及确认Node.js环境兼容性。
如果您在VSCode中安装了Live Sass Compiler扩展，但Sass或SCSS文件未能自动编译为CSS，则可能是由于扩展配置缺失、工作区设置冲突或文件监听路径异常。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、检查扩展是否启用并正确安装
Live Sass Compiler必须处于启用状态，且需确认其版本与当前VSCode兼容，否则无法触发监听和编译流程。
1、点击左侧活动栏的扩展图标（四个方块组成的图标）。
立即学习“前端免费学习笔记（深入）”；
2、在搜索框中输入Live Sass Compiler，确认结果中显示作者为Glenn Marks。
3、检查扩展右侧是否显示“已启用”按钮；若为“启用”则点击启用。
4、右键点击该扩展，选择“重新加载窗口”以确保插件完全加载。
二、验证Sass文件命名与位置规范
Live Sass Compiler默认仅监听以.sass或.scss结尾的文件，且要求文件名不以下划线开头（即非_partials.scss类的私有片段文件），否则不会触发编译。
1、确认目标文件扩展名为.scss或.sass。
2、重命名以下划线开头的文件（如_variables.scss）为非下划线前缀（如variables.scss）。
3、确保该文件位于工作区根目录或子目录中，而非VSCode未打开的外部路径。
三、配置settings.json启用自动编译
扩展依赖用户级或工作区级JSON配置来定义输出路径、格式及监听行为，缺失配置将导致编译功能静默失效。
1、按下Cmd+,（macOS）打开设置界面。
2、点击右上角“打开设置（JSON）”图标（两个大括号{}）。
3、在settings.json中添加以下配置块：
4、确保包含如下关键字段："liveSassCompile.settings.format": "expanded"、"liveSassCompile.settings.generateMap": true、"liveSassCompile.settings.autoprefix": ["last 2 versions"]。
5、保存文件后关闭并重新打开VSCode窗口。
四、手动触发编译并观察输出面板
当自动监听未响应时，可主动调用编译命令，同时通过输出面板验证扩展是否正常加载及报错信息。
1、按下Cmd+Shift+P打开命令面板。
2、输入并选择Live Sass Compile: Watch My Sass。
3、观察VSCode底部状态栏是否出现[Live Sass] Watching...提示。
4、点击底部状态栏中的[Live Sass]区域，查看输出面板中是否有编译成功日志或错误堆栈。
五、排除Node.js环境与全局依赖干扰
Live Sass Compiler部分功能依赖系统级Node.js运行时，若Node版本过低或PATH未正确配置，可能导致Sass解析器初始化失败。
1、终端中执行node -v，确认输出版本不低于v18.0.0。
2、执行which node，复制返回路径（如/opt/homebrew/bin/node）。
3、在VSCode设置JSON中添加："liveSassCompile.settings.nodePath": "/opt/homebrew/bin/node"。
4、重启VSCode并再次尝试Watch命令。
