PyCharm 2025.3 Help

代码风格。 CSS

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

制表符和缩进

使用制表符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新设置代码格式

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

智能制表符

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

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

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

制表符大小

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

缩进

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

续行缩进

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

在空行上保留缩进

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

空行

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

保留的空行数上限

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

最少空行数

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

其他

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

大括号放置位置

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

  • 在行尾

  • 下一行

对齐值

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

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

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

  • 按冒号对齐

引号

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

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

将右大括号与属性对齐

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

如果未选中此复选框,选择器的右大括号将放在选择器下方。

保留单行块

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

如果未选中此复选框,每个属性将单独占一行。

空格

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

注释

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

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

    默认情况下,当您将代码片段包含在块注释中时,文本会紧跟在开头的 /* 字符之后开始,不带任何空格。 在结尾的 */ 字符之前也不会插入空格。 这种默认代码风格可能与某些 linter 的规则冲突,例如 ESLint。

十六进制颜色

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

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

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

预览 窗格中查看更改。

排列

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

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

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

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

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

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

    PyCharm 会记住修改后的 自定义顺序 列表,并在您关闭自定义排序后再次开启时将其还原。

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

  • 在主菜单中,转到 代码 | 重排代码

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

对块内的 CSS 属性进行排序

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

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

设置来源

该链接会在页面右上角显示(如适用)。 点击此链接并选择要用作当前语言代码风格基础的语言。

要返回到代码风格设置的初始集合并放弃更改,请点击 重置

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