JetBrains Rider 2026.1 Help

Sass、SCSS、Less 和 PostCSS

JetBrains Rider 集成了将 SassLessSCSS 代码转换为 CSS 的编译器。 要在 JetBrains Rider 中使用编译器,您需要根据相关的预定义模板将其配置为 File Watcher

开始之前

  1. 请确保您的计算机上安装了 Node.js

  2. 请确保在 设置 | 插件 页面、 已安装 选项卡上启用了所需的 CSSSassLessFile Watchers 插件。 有关更多信息,请参阅 管理插件

安装 Sass/SCSS

  • 在内置的 终端Alt+F12 )中,输入:

    npm install -g sass

    了解更多信息,请访问 Sass 官方网站

安装 Less

  • 在内置的 终端Alt+F12 )中,输入:

    npm install --global less

    详细了解请访问 Less 官方网站

将您的代码编译为 CSS

要自动编译您的代码,您需要安装编译器并配置一个 Sass、Less 或 SCSS 文件监视器 ,该监视器将跟踪文件的更改并运行编译器。

当您打开文件时,JetBrains Rider 会检查当前项目中是否有适用的文件监视器。 如果已配置此类文件监视器但被禁用,JetBrains Rider 会显示一个弹出窗口,告知您已配置的文件监视器,并建议您启用它。

如果在当前项目中配置并启用了适用的文件监视器,JetBrains Rider 会在 新建监视器对话框 中指定的事件发生时自动启动编译器。

  • 如果选中 自动保存已编辑的文件以触发监视器 复选框,只要对源代码进行任何更改,文件监视器就会立即启动。

  • 如果清除 自动保存已编辑的文件以触发监视器 复选框,文件监视器会在保存时(文件 | 全部保存Ctrl+S )或当您将焦点从 JetBrains Rider 移开时(在帧停用时)启动。

JetBrains Rider 会创建一个包含生成输出的单独的文件。 该文件的名称与源 SassLessSCSS 文件名称相同,并且扩展名是 .css 。 生成文件的位置是在 要刷新的输出路径 字段中的 New Watcher 对话框中定义的。 然而,在 项目树 ,它们显示在源文件下,现在显示为一个节点。

创建文件监视器

  1. 设置/首选项 对话框(Ctrl+Alt+S )中,点击 文件监视器 下的 工具File Watchers 页面 显示了已配置的 File Watchers 列表。

  2. 单击 添加按钮 或按 Alt+Insert。 根据您将要使用的工具,从列表中选择 收起SassSCSS 预定义模板。

  3. 程序 字段中,根据所选择的预定义模板指定编译器归档的路径。

    • lessc 用于 Less。

    • sass 适用于 Sass/SCSS。

    如果您按照标准的 npm 安装程序进行操作,JetBrains Rider 会自动定位所需文件并自动填写字段。 否则,请手动输入路径或点击 “浏览”按钮 在打开的对话框中选择文件位置。

  4. 按照 文件监视器 中的说明进行操作。

示例:将 SCSS 编译为 CSS

假设您的项目结构如下:

将 SCSS 编译成 CSS:项目结构

如您所见, _grid.scss 被导入到了 Page.scss 中。 下面的示例展示了当您手动或自动保存项目时, Page.scss 如何编译为 CSS,以及对 _grid.scss 的更改如何反映到生成的 CSS 文件中。

  1. 创建一个类型为 SCSS 的文件监视器:打开 设置/首选项 对话框(Ctrl+Alt+S ),转到 工具 | 文件监视器 ,点击工具栏上的 "添加"按钮 ,并从列表中选择 SCSS

    将 SCSS 编译为 CSS:创建文件监视器
  2. 在打开的 新建文件监视程序 对话框中,所有必填字段都已填写。

    SCSS 文件监视器:设置

    其实,这些设置足以成功运行编译器。

  3. 让我们更改 grid.scss ,例如,将第 31 行的 margin-left: 0; 替换为 margin-left: 12px;。 这会触发我们的文件监视器,编译器会处理 Page.scss 。 结果将生成两个文件,并以嵌套形式显示在 Page.scss 下:

    • 包含已编译 CSS 代码的 Page.css

    • 包含源映射的 Page.css.map ,使您能够在调试会话期间逐步执行应用。

    SCSS 文件监视器:生成的 CSS 文件

虽然默认设置足以成功运行编译器,我们仍来仔细查看它们,看看如何自定义文件监视器的行为。

更改触发文件观察者的操作

文件监视器唤醒并启动 transpiler,一旦您的项目被手动保存(文件 | 全部保存Ctrl+S )或自动保存。

一般来说,当您将焦点从 JetBrains Rider 移开时(框架停用),代码会自动保存。 使用文件监视器时,当您编辑属于文件监视器范围的文件时,也会执行自动保存。 因此,在您输入时,转译器可能一直在运行,这可能导致性能问题。 为解决该问题,抑制自动保存已编辑的文件。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 选择所需的文件监视器(我们的示例中为 SCSS ),并单击工具栏上的 “编辑”按钮。 在 编辑文件监视程序 对话框中,展开 高级选项 区域并清除 自动保存已编辑的文件以触发监视器 复选框。

已关闭自动保存已编辑的文件

默认情况下,即使从 JetBrains Rider 外部编辑其范围内的文件,文件监视器也会唤醒。 要覆盖此行为,并仅在内部编辑时转译文件,请清除 在外部更改时触发监视器 复选框。

在外部更改时触发文件监视器已关闭

更改范围

默认情况下,JetBrains Rider 会监视整个项目中所有具有 .scss 扩展名的文件的更改。 这适用于我们的示例。 不过,您可以更改范围,例如仅处理未提交的更改。 在大型项目中,这将节省时间。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 选择所需的文件监视器(我们的示例中为 SCSS ),并单击工具栏上的 “编辑”按钮。 在 编辑文件监视程序 对话框中,从列表中选择适用的作用域。 更多信息请参阅 文件作用域与文件颜色

SCSS 文件监视器:更改默认作用域

自定义输出位置

默认情况下,生成的 .css .css.map 文件存储在原始文件所在的文件夹中,并作为其子项显示在 资源管理器 工具窗口(Alt+1 )中。 您可以更改此默认行为,将所有生成的 .css .css.map 文件存储在单独的文件夹中。

让我们先从一个简单的情况开始。 假设项目根目录中有一个 custom_output.scss 文件。

项目结构

我们来编辑 custom_output.scss ,例如,将第 6 行的 fill-opacity: abs(50); 替换为 fill-opacity: abs(60);。 使用默认的文件监视器配置时,生成的文件 custom_output.css custom_output.css.map 将存储在项目根目录中,并作为 custom_output.scss 的子项显示。

默认设置:输出存储在项目根目录

将所有输出存储在单独的文件夹中会更方便,例如 css 。 我们创建一个自定义的 SCSS_custom_output 文件监视器,并将 css 文件夹设为输出位置。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 然后创建一个 SCSS 文件监视器 如上所述

请按以下步骤更新默认设置:

  • 参数 字段中,键入:

    $FileName$:$ProjectFileDir$/css/$FileNameWithoutExtension$.css
  • 要刷新的输出路径 字段中,键入:

    $ProjectFileDir$/css/$FileNameWithoutExtension$.css:$ProjectFileDir$/css/$FileNameWithoutExtension$.css.map
具有自定义输出路径的新文件监视器

保存新建的文件监视器,并确保已启用它。

具有自定义输出路径的新文件监视器已保存并启用

现在,如果您编辑 custom_output.scss ,例如,将第 6 行的 fill-opacity: abs(50); 替换为 fill-opacity: abs(60); ,JetBrains Rider 会创建一个 css 文件夹,并将生成的 custom_output.css custom_output.css.map 文件存储在其中。

自定义设置:输出存储在单独的文件夹中

自定义输出位置:保留原始文件夹结构

现在考虑一个示例,其中 .scss 文件存储在文件夹结构中,例如:

项目结构

默认的 File Watcher 会将生成的文件存储在原始 .scss 文件旁边。

自定义输出:生成的文件存储在源文件下

如果我们使用 上述说明 中的自定义 File Watcher,所有生成的文件将存储在同一个 css 文件夹中:

自定义输出:生成的文件以扁平结构存储在单独的文件夹中

要让 JetBrains Rider 保留文件夹结构,我们再创建一个自定义文件监视器。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 然后创建一个 SCSS 文件监视器 如上所述

请按以下步骤更新默认设置:

  • 参数 字段中,键入:

    $FileName$:$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css
  • 要刷新的输出路径 字段中,键入:

    $ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css:$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css.map
带文件夹结构的自定义输出:已更新文件监视器

保存新建的文件监视器,并确保已启用它。

带文件夹结构的自定义输出:文件监视器已保存并启用

现在,如果您编辑 custom_output_body.scss custom_output_header.scss custom_output_footer.scss ,JetBrains Rider 会创建一个 css 文件夹,其子文件夹结构与 样式结构 的结构一致。

自定义设置:输出存储在单独的文件夹中,结构保留

示例:将 Less 编译成 CSS

假设,您的项目结构如下:

将 Less 编译成 CSS:项目结构

下面的示例展示了当您手动或自动保存项目时, my-styles.less 如何编译为 CSS,以及对 my-styles.less 的更改如何反映在生成的 CSS 文件中。

  1. 创建一个类型为 收起 的文件监视器:打开 设置/首选项 对话框(Ctrl+Alt+S ),转到 工具 | 文件监视器 ,点击工具栏上的 "添加"按钮 ,并从列表中选择 收起

    将 Less 编译为 CSS:创建一个文件监听器

    或者,点击 在编辑器选项卡顶部的 启用文件监视器以将 LESS 编译为 CSS? 面板中用 .收起 文件。

    将 Less 编译为 CSS:从编辑器窗格中创建一个 File Watcher
  2. 在打开的 新建文件监视程序 对话框中,所有必填字段都已填写。

    Less 文件监视器:设置

    其实,这些设置足以成功运行编译器。

  3. 让我们更改 my-styles.less ,例如,更改第 1 行的 @color 的值。 这会触发我们的 File Watcher。 因此,生成了两个文件并显示在 my-styles.less 下:

    • 包含已编译 CSS 代码的 my-styles.css

    • 包含源映射的 my-styles.css.map ,使您能够在调试会话期间逐步执行应用。

    Less File Watcher:生成了一个 CSS 文件

虽然默认设置足以成功运行编译器,我们仍来仔细查看它们,看看如何自定义文件监视器的行为。

更改触发文件观察者的操作

文件监视器唤醒并启动 transpiler,一旦您的项目被手动保存(文件 | 全部保存Ctrl+S )或自动保存。

一般来说,当您将焦点从 JetBrains Rider 移开时(框架停用),代码会自动保存。 使用文件监视器时,当您编辑属于文件监视器范围的文件时,也会执行自动保存。 因此,在您输入时,转译器可能一直在运行,这可能导致性能问题。 为解决该问题,抑制自动保存已编辑的文件。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 选择所需的文件监视器(我们的示例中为 收起 ),并单击工具栏上的 “编辑”按钮。 在 编辑文件监视程序 对话框中,展开 高级选项 区域并清除 自动保存已编辑的文件以触发监视器 复选框。

已关闭自动保存已编辑的文件

更改范围

默认情况下,JetBrains Rider 会监视整个项目中所有具有 .scss 扩展名的文件的更改。 这适用于我们的示例。 不过,您可以更改范围,例如仅处理未提交的更改。 在大型项目中,这将节省时间。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 选择所需的文件监视器(我们的示例中为 收起 ),并单击工具栏上的 “编辑”按钮。 在 编辑文件监视程序 对话框中,从列表中选择适用的作用域。 更多信息请参阅 文件作用域与文件颜色

SCSS 文件监视器:更改默认作用域

自定义输出位置

默认情况下,生成的 .css .css.map 文件存储在原始文件所在的文件夹中,并作为其子项显示在 资源管理器 工具窗口(Alt+1 )中。 您可以更改此默认行为,将所有生成的 .css .css.map 文件存储在单独的文件夹中。

让我们先从一个简单的情况开始。 假设项目根目录中有一个 custom_output.less 文件。

项目结构

让我们编辑 custom_output.less ,例如,将第 1 行的 @color 的值更改。 默认的 File Watcher 配置生成的文件 custom_output.css custom_output.css.map 将会存储在项目根目录并显示为 custom_output.less 的子文件。

默认设置:输出存储在项目根目录

将所有输出存储在单独的文件夹中会更方便,例如 css 。 我们创建一个自定义的 自定义输出较少 文件监视器,并将 css 文件夹设为输出位置。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 然后根据 上述说明 创建一个 Less File Watcher。

请按以下步骤更新默认设置:

  • 参数 字段中,键入:

    $FileName$ $ProjectFileDir$/css/$FileNameWithoutExtension$.css --source-map
  • 要刷新的输出路径 字段中,键入:

    $ProjectFileDir$/css/$FileNameWithoutExtension$.css $ProjectFileDir$/css/$FileNameWithoutExtension$.css.map
具有自定义输出路径的新文件监视器

保存新建的文件监视器,并确保已启用它。

具有自定义输出路径的新文件监视器已保存并启用

现在,如果您编辑 custom_output.less ,例如,更改第 1 行的 @color 的值,JetBrains Rider 会创建一个 css 文件夹,并将生成的 custom_output.css custom_output.css.map 文件存储在其中。

自定义设置:输出存储在单独的文件夹中

自定义输出位置:保留原始文件夹结构

现在考虑一个示例,其中 .收起 文件存储在文件夹结构中,例如:

项目结构

默认的 File Watcher 会将生成的文件存储在原始 .收起 文件旁边。

自定义输出:生成的文件存储在源文件下

如果我们使用 上述说明 中的自定义 File Watcher,所有生成的文件将存储在同一个 css 文件夹中:

自定义输出:生成的文件以扁平结构存储在单独的文件夹中

要让 JetBrains Rider 保留文件夹结构,我们再创建一个自定义文件监视器。

按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 文件监视器。 然后根据 上述说明 创建一个 Less File Watcher。

请按以下步骤更新默认设置:

  • 参数 字段中,键入:

    $FileName$ $ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css --source-map
  • 要刷新的输出路径 字段中,键入:

    $ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css $ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css.map
带文件夹结构的自定义输出:已更新文件监视器

保存新建的文件监视器,并确保已启用它。

带文件夹结构的自定义输出:文件监视器已保存并启用

现在,如果您编辑 custom_output_body.less custom_output_header.less custom_output_footer.less ,JetBrains Rider 会创建一个 css 文件夹,其子文件夹结构与 样式结构 的结构一致。

自定义设置:输出存储在单独的文件夹中,结构保留

配置语法高亮

您可以根据您的偏好和习惯配置 Less/Sass/SCSS/PostCSS 语法高亮显示。

  1. 设置/首选项 对话框(Ctrl+Alt+S ),转到 编辑器 | 配色方案 | Less/Sass/SCSS/PostCSS

  2. 选择配色方案,接受从默认设置继承的高亮设置,或按照 配色方案:IDE 文本的字体和颜色 中的说明进行自定义。

完成 Sass 和 SCSS 选择器

JetBrains Rider 提供对 Sass 和 SCSS 选择器的补全——包括 嵌套选择器使用和号(&)创建的选择器

Sass 和 SCSS 选择器的补全

云补全和整行补全

JetBrains Rider 在 Sass/SCSS、Less 和 PostCSS 代码中提供 Cloud CompletionFull Line 补全

整行代码补全功能使用本地运行的深度学习模型来建议整行代码。 该功能在 JetBrains Rider 中开箱即用,且无需额外许可。

启用整行代码补全

  1. Ctrl+Alt+S 打开设置并选择 编辑器 | 常规 | 内嵌补全

  2. 选中 启用本地Full Line 补全建议 复选框,并确保选中 类 CSS 复选框。

    启用整行补全

由 AI Assistant 驱动的云补全可以基于项目上下文实时自动补全单行代码、代码块,甚至整个函数。

Cloud Completion 会在考虑上下文的情况下,建议语法上可接受的解决方案,并预先运行各种 代码检查 ,以拒绝会导致错误的候选项。

启用云补全

  1. 安装并启用 AI Assistant 插件

  2. Ctrl+Alt+S 打开设置并选择 编辑器 | 常规 | 内嵌补全

  3. 选中 Enable cloud completion suggestions 复选框,并确保选中 HTML 复选框。

    在 CSS 中启用云补全

搜索和导航

SCSS 选择器导航
  • 若要查找样式表符号的用法,请将文本光标放在符号上并按 Alt+F7。 了解更多信息,请参阅 在项目中搜索用法

  • 要从 Style Sheet 符号的使用跳转到其定义,请按 Ctrl+B。 导航到定义适用于类、id、选择器——包括嵌套选择器和带有 & 的选择器——以及变量和 mixins。

    了解更多信息,请点击 Go to declaration

文档查找

对于属性和伪元素,JetBrains Rider 可以向您显示相应的 MDN 文章 摘要。 此摘要显示在 文档 弹出窗口中,该窗口会显示属性及其值的简要说明,以及其 Web 平台基线状态

样式表快速文档:基线,广泛可用
样式表快速文档:基线,新近可用
样式表快速文档:基线,可用性有限

对于选择器,JetBrains Rider 还显示其 特异性

文档查找:选择器的特异性

查看属性文档

  • 将文本光标定位在属性上,然后按 Ctrl+Q 或从主菜单中选择 查看 | 快速文档查找

  • 当您悬停在某属性上时,JetBrains Rider 会立即在 文档 弹出窗口中显示其引用。

    您可以关闭此行为或配置弹出窗口的显示速度,更快或更慢,详见下文 配置文档弹出窗口的行为

配置文档弹出窗口的行为

  • 要关闭在悬停代码符号时自动显示文档的功能,请点击弹出窗口中的 显示选项菜单图标 ,并禁用 在鼠标移动时显示 选项。

  • 要调整 文档 弹窗的显示速度,请打开 设置/首选项 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规 | 代码完成 ,然后选择 显示文档弹窗 复选框并指定延迟时间。

在浏览器中打开 MDN 文档

  • 文档 弹出窗口 Ctrl+Q 中,点击底部的链接。

  • Shift+F1 或从主菜单中选择 视图|外部文档

重构

借助 JetBrains Rider,您可以将样式表中的表达式转换为变量,并使用 var(--var-name) 语法在 .css 文件中引入这些变量,或使用 $ 语法在 .scss .sass 文件中引入。

样式表:引入变量

引入变量

  1. 在编辑器中,将文本光标放在要转换为变量的表达式处,然后按 Ctrl+Alt+V 或从上下文菜单或主菜单中选择 重构 | 引入 | 引入变量

  2. 如果找到多个所选表达式的出现位置,请从 找到多个出现位置 列表中选择 仅替换此处替换所有匹配项

  3. 对于 .scss .sass ,请为变量选择 全局局部 作用域。

  4. 在红色边框的字段中,接受建议的变量名或指定自定义名称。 按 Enter 准备。

使用 JetBrains Rider,您可以从 CSS、SCSS、Sass 或 Less 文件中的现有声明创建新的规则集,甚至可以通过重构和意图操作在文件之间移动整个规则集。

引入规则集

  1. 请选择要引入的声明。 如果您只需要一个声明,只需将文本光标放在其中。

  2. Alt+Enter 并从列表中选择 引入规则集

JetBrains Rider 创建一个具有相同选择器的新规则集,并将选定声明移到其中。 如果选中内容包含注释、嵌套选择器等,它们也会移到新的规则集中。

将规则集移到其他文件

  1. 请将文本光标放在规则集中任意位置并按 F6

  2. 在打开的对话框中,指定要移动规则集的文件。 如果指定的文件不存在,JetBrains Rider将建议创建它。

  3. 默认情况下,JetBrains Rider 会自动打开规则集所在的文件。 要更改此行为,请清除 在编辑器中打开 复选框。

常见的重构操作,如 CopyMoveRename ,也可用。

重命名重构

检查与浏览器的兼容性

除了 在文档弹出窗口中查找外,您还可以即时检查样式表属性与特定浏览器的兼容性。 此检查基于 MDN Browser Compatibility Data ,每当某个属性在目标浏览器之一中不受支持时,系统都会向您显示警告。

样式表兼容性检查弹出窗口

打开兼容性检查

  1. 设置/首选项 对话框(Ctrl+Alt+S ),转到 编辑器|检查

  2. 展开 CSS 节点并选择 属性与选定浏览器不兼容。 在 选项 区域,选择您要针对的浏览器及其最低版本。

  3. 选项 区域中,选择用于检查属性可用性的浏览器。 指定所选浏览器的目标版本。

CSS 兼容性检查设置

管理颜色

JetBrains Rider 支持 CSS 颜色管理,包括 代码补全快速文档查询颜色预览。 为绝对、相对和混合颜色提供编码辅助。

颜色管理的编码辅助

指定颜色

  • 将插入符号置于 color 属性处,按 Ctrl+Space ,然后选择所需的颜色值,或用 选择颜色... 选择自定义颜色。

    选择颜色
  • 要使用代码代替可读的颜色名称,请按 Alt+Enter 并从列表中选择 将颜色转换为 <color code system> ,其中<color code system>为 HEXHSLHWBRGBlchoklchoklab

    使用代码代替颜色名称

更改颜色

  • 点击装订区域中的颜色图标,并在弹窗中选择所需颜色。

    拾取颜色
  • 或者,将插入符号置于颜色属性处,按 Alt+Enter ,在列表中选择 更改颜色 ,然后在弹窗中选取所需颜色。

    更改颜色 - 上下文菜单

切换颜色预览

JetBrains Rider 可为绝对、相对和混合颜色显示预览。

颜色预览简介
  • 默认情况下,JetBrains Rider 会在标尺中以图标显示颜色预览。 要在背景中显示颜色预览,请打开 设置/首选项 对话框(Ctrl+Alt+S ),转到 编辑器 | 外观 并选中 将 CSS 颜色预览显示为背景 复选框。

    在背景中显示颜色预览
  • 要恢复装订区域中的颜色预览图标,请打开 设置/首选项 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规 | 装订线图标 ,并在 通用 区域中选中 颜色预览 复选框。

    在装订区域启用颜色预览

查看应用于标签的样式

在 HTML 和 XHTML 文件中,JetBrains Rider 可以显示应用于任意标签的所有样式。

查看应用到 <body> 标签的样式
  • 从标签的上下文菜单中选择 显示标签的应用样式

    JetBrains Rider 打开 CSS 样式 工具窗口,工具窗口有两个窗格,左侧窗格显示标签的样式,右侧窗格显示它们的定义。 对于每个标签,JetBrains Rider 会打开一个单独的选项卡。

    从工具窗口,您可以导航到源代码中的标签和属性定义。

    • 跳转到标签,请点击左侧窗格工具栏上的 “导航到标签”工具栏按钮

    • 要跳转到某属性的定义,请在左侧窗格中选择它,然后点击右侧窗格工具栏上的 “导航到样式来源”按钮

2026年 3月 25日