WebStorm 2025.2 Help

代码样式。 SCSS

使用此页面配置 SCSS 文件的格式设置选项。 当您更改这些设置时, 预览 面板会显示这对代码的影响。

制表符与缩进

使用制表符字符

  • 选中此复选框后,将使用制表符字符:

    • 按下 Tab 键时

    • 用于缩进

    • 用于代码重排

  • 如果未选中复选框,WebStorm 将使用空格而不是制表符。

智能制表符

一个缩进由两部分组成。 一部分来自嵌套代码块,另一部分由对齐方式决定。

  • 选中此复选框后,嵌套产生的部分将包含制表符和空格(如有必要),而对齐定义的部分仅包含空格。

  • 如果未选中此复选框,则只使用制表符。 这意味着在重新格式化后,符合指定制表符大小的一组空格将自动替换为制表符,这可能会破坏精细对齐。

制表符宽度

在此字段中,指定一个制表符等价的空格数。

缩进

在此字段中,指定每级缩进所使用的空格数。

续行缩进

在此字段中,设置在属性值之间插入的空格数量。

在空行上保留缩进

选中该复选框后,WebStorm 会像空行中包含代码一样保留其缩进。 取消选中该复选框后,WebStorm 将删除空行中的制表符和空格。

空行

使用此选项卡可定义重新格式化后 WebStorm 在代码中保留和插入空行的位置和数量。 结果将显示在 预览 窗格中。

保留最大空行数

在该区域中,指定重新格式化后保留的额外空行数。

最小空行数

在此区域中配置是否在顶层代码块和嵌套选择器周围添加额外空行。 在每个选项旁的字段中指定应保留的最小空行数。

其他

在此选项卡中,指定重新格式化时应应用的对齐、大括号、空格和引号选项。

大括号放置位置

使用此列表可指定 WebStorm 应将选择器的大括号放置在何处。 可用选项包括:

  • 在行尾

  • 下一行

对齐值

使用此列表可指定 WebStorm 应如何对齐属性及其值。 可用选项包括:

  • 不对齐 :选择此选项可在属性名的首字符处对齐。

  • 对值 :选择此选项可在属性值的首字符处对齐。

  • 对冒号

引号

在 CSS、SCSS 和 Less 环境中,WebStorm 默认使用双引号生成 import 语句和 URL 中的字符串文本。 要使用单引号,请从此列表中选择 单引号

要在重新格式化后将所选样式应用于整个文件,请选中列表下方的 格式化时强制应用 复选框。

将结束大括号与属性对齐

选中该复选框后,选择器的结束大括号将置于属性列表下方。

未选中该复选框时,选择器的结束大括号将置于选择器下方。

保留单行代码块

选中该复选框后,仅含一个属性的代码块将保留在同一行上。

未选中该复选框时,每个属性将单独放置在其所属的行上。

空格

选中此区域中的复选框可在键与值之间的冒号后,以及选择器的大括号前添加空格。

注释

使用该区域中的控件配置行注释和块注释的位置及其内部空格。

  • 行注释在第一列 :选中此复选框可将行注释起始位置设置在第一列。 取消选中该复选框后,行注释将在代码中对齐。

  • 在行注释开始处添加空格 :选中该复选框后,将在行注释符号与注释行首字符之间插入一个空格。

  • 在块注释周围添加空格 :选中该复选框后,将在块注释中添加前导和尾随空格。

    默认情况下,将代码片段置于块注释中时,文本会紧接着 /* 起始字符出现,无空格。 在 */ 结束字符前也不会插入空格。 此默认代码风格可能与某些 linter 的规则冲突,例如 ESLint。

HEX 颜色

请在此区域配置 hex 颜色语法。 您可以从以下勾选项中进行选择:

  • 将十六进制颜色转换为 :选中此复选框可配置 hex 颜色的字母大小写。 您可以选择 小写大写

  • 将十六进制颜色格式转换为 :选中此复选框可配置 hex 颜色格式长度。 您可以选择 长格式短格式

预览 面板中查看更改。

排列

在此选项卡中启用对 SCSS 文件中 CSS 属性的排序(默认关闭),并选择排序顺序。

  • 要启用排序,请勾选 排序 CSS 属性 复选框。

  • 选择 按名称 以按字母顺序对每个块中的所有 CSS 属性进行重新排序。 WebStorm 忽略特定于供应商的前缀,但会对某个属性的多个供应商前缀进行按字母顺序排序。

    border: 1px solid; -moz-border-radius: 4px; -webkit-border-radius: 4px; border-radius: 4px; color: black;
  • 要定义您自己的排序策略,请选择 自定义顺序 选项,并在其旁边的字段中指定所需的排序顺序。

    请使用逗号和空格作为分隔符,并跳过特定于供应商的属性,因为 WebStorm 始终将它们和相应的无前缀属性归为一组。 在此类组内,属性根据供应商前缀排序,且无前缀的属性排在最后。

    自定义顺序 列表中可以使用正则表达式,例如, .* 可匹配任何属性。

    WebStorm 会记住修改后的 自定义顺序 列表,并在关闭自定义排序后重新启用时恢复该列表。

对 SCSS 文件中的所有 CSS 属性排序

  • 转到 代码 | 重排代码

  • 或者,从主菜单中选择 代码 | 重新格式化文件 ,然后在打开的对话框中选择 整个文件重排代码

对代码块内的 CSS 属性排序

  • 选择要排序的代码块,然后从主菜单中选择 代码 | 重排代码

  • 或者,在主菜单中转到 代码 | 重新格式化文件 ,然后在打开的对话框中选择 重排代码

设置来源

在适用的情况下,该链接会出现在页面右上角。 点击此链接并选择要作为当前语言代码风格基础的语言。

要恢复到初始的代码风格设置并放弃所做更改,请点击 重置

最后修改日期: 2025年 9月 26日