PyCharm 2025.3 Help

代码样式。 SCSS

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

制表符和缩进

使用制表符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新格式化代码

  • 如果清除此复选框,PyCharm 将使用空格而非制表符。

智能制表符

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

  • 选中此复选框后,源自嵌套的部分可包含制表符和空格(如有必要),而由对齐定义的部分仅由空格组成。

  • 清除此复选框后,仅使用制表符。 这意味着,重新格式化后,符合指定制表符大小的一组空格会自动替换为一个制表符,这可能会破坏精细的对齐。

制表符大小

在此字段中,指定一个制表符所包含的空格数。

缩进

在此字段中,指定每个缩进级别要插入的空格数。

续行缩进

在此字段中,指定属性值之间要插入的空格数。

在空行上保留缩进

选中此复选框后,PyCharm 会在空行上保留缩进,就像其中包含代码一样。 清除此复选框后,PyCharm 会删除空行上的制表符和空格。

空行

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

保留的最大空行数

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

最少空行数

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

其他

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

大括号放置

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

  • 在行尾

  • 下一行

对齐值

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

  • 不对齐 :选择此选项以按属性名的第一个字符对齐。

  • 对齐到值 :选择此选项以按属性值的第一个字符对齐。

  • 对齐到冒号

引号

在 CSS、SCSS 和 Less 上下文中,PyCharm 默认在 import 语句和 URL 中对生成的字符串字面量使用双引号。 要使用单引号,请在此列表中选择 单引号

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

将右大括号与属性对齐

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

未选中此复选框时,选择器的右大括号将置于选择器下方。

保留单行块

选中此复选框后,包含单个属性的块将限制为单行。

未选中此复选框时,每个属性都将放在其各自的一行中。

空格

在此区域中选中相应复选框,以在分隔键和值的冒号之后以及选择器左大括号之前添加空格。

注释

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

  • 行注释在第一列 :选择此复选框以在第一列开始行注释。 清除此复选框后,行注释将与代码对齐。

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

  • 在块注释周围添加空格 :选择此复选框以在块注释的开头和结尾添加空格。

    默认情况下,当您将代码片段括在块注释中时,文本会在起始 /* 字符之后立即开始,不带任何空格。 在结束 */ 字符之前也不会插入空格。 此默认代码样式可能与某些 linter 的规则冲突,例如 ESLint。

HEX 颜色

使用此区域配置十六进制颜色语法。 您可以从以下复选项中进行选择:

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

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

预览 窗格中查看更改。

排列

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

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

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

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

    使用逗号和空格作为分隔符,并跳过供应商特定属性,因为 PyCharm 始终将它们与对应的不带前缀的属性分组。 在此类分组内,属性按供应商前缀排序,不带前缀的属性排在最后。

    自定义顺序 列表中支持正则表达式,例如, .* 可匹配任意属性。

    PyCharm 会记住修改后的 自定义顺序 列表,如果您先关闭自定义排序然后再次开启,将恢复该列表。

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

  • 转到 代码 | 重排代码

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

对块中的 CSS 属性进行排序

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

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

设置来源

在适用时,链接会显示在页面右上角。 点击此链接,然后选择要作为当前语言代码样式基础的语言。

要恢复初始的代码样式设置并放弃更改,请点击 重置

最后修改日期: 2025年 12月 2日