WebStorm 2025.2 Help

代码风格。 CSS

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

制表符与缩进

使用制表符字符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新格式化代码

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

智能制表符

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

  • 如果选中此复选框,嵌套部分包含(如有必要)制表符和空格,对齐部分仅由空格组成。

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

制表符大小

在该字段中,指定一个制表符所代表的空格数。

缩进

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

续行缩进

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

保留空行上的缩进

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

空行

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

保留最大空行数

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

最小空行数

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

其他

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

大括号位置

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

  • 行尾

  • 下一行

值对齐

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

  • 不对齐 :选择此选项将在属性名称的第一个字符处对齐。

  • 对值对齐 :选择此选项将在属性值的第一个字符处对齐。

  • 对冒号对齐

引号

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

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

对齐闭合大括号与属性行

如果选中此复选框,选择器的闭合大括号将放置在属性列表下方。

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

保留单行代码块

如果选中此复选框,包含单个属性的代码块将限制在一行内。

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

空格

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

注释

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

  • 在块注释周围添加空格 :选中此复选框可在块注释中添加前导和结尾空格。

    默认情况下,在将代码片段包围在块注释中时,文本将直接从开头的 /* 字符后开始,不带空格。 结尾的 */ 字符前也不会插入空格。 此默认代码风格可能与某些 linter 工具的规则(例如 ESLint)存在冲突。

十六进制颜色

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

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

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

预览 窗格中查看更改。

排列

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

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

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

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

    请使用逗号及空格作为分隔符,并跳过特定于厂商的属性,因为 WebStorm 总是将它们与相应的无前缀属性组合在一起。 在此类组中,属性将按厂商前缀排序,无前缀属性排在最后。

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

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

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

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

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

对块内的 CSS 属性排序

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

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

设置来源

该链接在适用时会出现在页面右上角。 单击此链接并选择要用作当前语言代码样式基础的语言。

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

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