需安装 mrmlnc 的 SCSS IntelliSense 扩展,设置文件语言模式为 SCSS,配置 settings.json 启用 sassIntelliSense 和 trace.server,创建 .sassrc.json 指定 includePaths,并禁用内置 CSS 语言功能以避免冲突。

如果您在使用 VSCode 编辑 SCSS 文件时发现颜色变量、嵌套选择器或 mixin 调用缺乏实时提示与跳转支持,则可能是 SCSS IntelliSense 功能未正确启用或配置。以下是激活并优化该功能的具体操作路径:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装官方 SCSS IntelliSense 扩展
VSCode 默认不内置 SCSS 语言智能感知能力,需通过扩展提供语法解析、符号索引与自动补全支持。该扩展由 mrmlnc 官方维护,兼容现代 SCSS 语法特性,包括模块系统(@use / @forward)与自定义函数识别。
1、打开 VSCode,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。
立即学习“前端免费学习笔记(深入)”;
2、在搜索框中输入 SCSS IntelliSense,找到作者为 mrmlnc 的扩展。
3、点击“安装”按钮,安装完成后点击“重新加载”使扩展生效。
二、启用 SCSS 语言模式并验证语法高亮
VSCode 必须将当前文件识别为 SCSS 类型,才能触发扩展的语义分析逻辑。若文件后缀为 .scss 但右下角显示“Plain Text”或“CSS”,则 IntelliSense 将完全失效。
1、打开任意 .scss 文件,观察窗口右下角状态栏。
2、若显示非 SCSS,点击该文本,弹出语言选择菜单。
3、在菜单中选择 SCSS,确保图标变为 Sass 相关标识。
三、配置 settings.json 启用高级提示选项
默认配置仅启用基础补全,需手动开启嵌套作用域推导、变量来源追踪及 @use 模块路径解析,以支持跨文件变量与 mixin 的跳转与提示。
1、按下 Cmd+, 打开设置界面,点击右上角“打开 settings.json”图标。
2、在 "settings.json" 文件中添加以下配置项:
3、插入代码块:"scss.sassIntelliSense": true。
4、插入代码块:"scss.trace.server": "verbose"(用于诊断初始化失败问题)。
四、解决 @use 路径无法解析的问题
当项目采用 Dart Sass 模块系统时,IntelliSense 需明确知道导入路径映射关系,否则无法定位 _variables.scss 中定义的颜色常量。
1、在项目根目录创建 .sassrc.json 文件。
2、写入内容:{"includePaths": ["src/styles"]},其中 src/styles 为存放 _base.scss 等模块的实际路径。
3、重启 VSCode 窗口(Cmd+Shift+P → Developer: Reload Window)。
五、禁用冲突的 CSS 语言功能
VSCode 内置的 CSS 语言服务器会与 SCSS IntelliSense 在相同文件类型上竞争控制权,导致跳转失效或提示重复,必须显式关闭其对 SCSS 文件的支持。
1、打开 settings.json 文件。
2、添加配置项:"css.validate": false。
3、添加配置项:"css.languages": []。










