WebStorm 2025.2 Help

代码样式

方案

在此区域中,选择 代码样式方案 ,并根据需要进行更改。 每次 WebStorm 生成、重构或重新格式化代码时,代码样式方案设置会自动应用。

IDE 包含两个预定义方案: 项目 方案和 默认 方案。

  • 项目 方案中,配置的设置仅适用于当前项目。

    这些设置存储在 codeStyles 文件夹中的 .idea 下,并通过 VCS 与项目一起共享。

    在您修改项目的代码样式设置后,IDE 会创建该文件夹。

  • 默认 方案(IDE 级别方案)中,配置的设置适用于所有已选择 默认 代码样式方案的现有项目。

    这些设置存储在 WebStorm 的 codestyles 文件夹下的 配置目录 中,并不会通过 VCS 共享。

如果您希望将项目代码样式方案用作默认方案,可以将其复制到 IDE 级别。 也可以反过来操作:您可以使用 IDE 级别方案的设置覆盖当前项目设置,并与团队其他成员共享。

项目

描述

方案

在此列表中,选择要使用的方案。 预定义 方案以加粗显示。 自定义 方案(基于预定义方案复制生成)以普通文本显示。 每个方案旁边显示了其所在位置,例如 默认 方案存储在 IDE 中, 项目 方案存储在项目中。

显示方案操作

单击此按钮以调用管理方案的命令列表:

  • 复制到IDE… :选择此选项可将方案设置复制到 WebStorm。

  • 导出 :选择此选项以将选定的方案导出为 IntelliJ IDEA 代码样式 XMLEditorConfig 格式(如果启用了 EditorConfig 插件)。

    导出代码样式方案

    详细信息请参阅 使用 EditorConfig 按目录级别管理代码风格

  • 导入方案 :选择此选项可从指定位置导入所选类型的方案。

    导入方案
  • 复制项目 :选择此选项可使用所选 IDE 代码样式方案的设置覆盖当前项目的代码样式设置。

  • 复制… :选择此选项以创建所选方案的副本。

  • 重置 :选择此选项以将默认或预置的配色方案重置为 WebStorm 附带的初始默认设置。 仅当做出更改后,此命令才会可用。

  • 重命名 :选择此选项以更改所选自定义方案的名称。 按 Enter 保存更改,或按 Escape 取消。

常规

行分隔符

WebStorm 允许您为各种语言配置行分隔符和缩进选项。 在 重新格式化源代码 时,WebStorm 将应用指定的缩进行为,并跳过使用格式化开/关标记标记的部分。

项目

描述

行分隔符

使用此列表指定 WebStorm 创建的文件中使用的 行分隔符。 可用选项包括:

  • 取决于系统 :选择此选项以使用操作系统的默认分隔符。

  • Unix 和 macOS (\n) :选择此选项以使用 Unix 和 macOS 行分隔符。

  • Windows (\r\n) :选择此选项以使用 Windows 行分隔符。

  • Classic Mac OS (\r) :选择此选项以使用 \r 行分隔符,该分隔符曾用于 Classic Mac OS (直至 Mac OS 9)。

强制换行位置

在此字段中,指定用于在编辑器中显示页面的列数。

键入时换行

选中此复选框以确保编辑文本始终适应指定的右边距。

视觉参考线

在此字段中,指定多个右边距。 您可以保留默认值,也可以输入边距的空格数。 如果要指定多个边距,请输入以逗号分隔的数字。

缩进检测

选择 检测并使用现有的文件缩进进行编辑 可以检测当前文件中的 缩进样式 ,并使用该样式替代特定语言在 Code Style 设置中指定的缩进方式。

WebStorm 会在编辑器的状态栏中显示缩进信息。 您可以单击缩进信息以查看可用操作,例如启用或禁用此选项,以及将当前缩进更改为 Code Style 设置中为特定语言指定的样式。

状态栏缩进选项

EditorConfig

选中 启用EditorConfig 支持 复选框以使用 EditorConfig 配置代码样式。 在这种情况下,您可以指定覆盖 IDE 设置的代码样式配置,并在项目中使用不同的代码样式。

如果在创建 EditorConfig 设置文件后决定使用 IDE 设置,您需要清除 启用EditorConfig 支持 复选框。

格式化器

在此区域中,指定标记以限定要从 重新格式化中排除的代码片段。 在源代码中,格式化标记写在 行注释中。

描述

不设置格式

不设置格式 字段中,指定一个包含要从 重新格式化代码排布导入优化中排除的文件和目录名称的 glob 模式 ,例如: *.{html,htm}

您可以指定多个以分号 ; 分隔的 glob 模式。

使用星号 * 通配符可完全禁用重新格式化。

在代码注释中使用标记打开/关闭格式化程序

  • 启用此选项后,带有格式化标记的行注释之间的代码片段将根据这些标记重新格式化:带有开启标记的片段会被重新格式化,而带有关闭标记的片段则在代码重新格式化后保持不变。 请参阅 使用格式化标记的示例

    选中该复选框后,下方字段将可用,您可以指定要作为格式化标记处理的字符串。

  • 禁用此选项后,将忽略格式化标记,并重新格式化带有标记的行注释之间的代码。

关:

在此字段中,指定字符字符串,用于表示您希望从重新格式化中排除的代码片段的开始位置。 键入一个带有 @ 符号前缀的字符串,或保留预定义值 @formatter:off

开:

在此字段中,指定字符字符串,用于表示您希望从重新格式化中排除的代码片段的结束位置。 键入一个带有 @ 符号前缀的字符串,或保留预定义值 @formatter:on

在格式化程序标记中启用正则表达式

选中该复选框以使用正则表达式,而不是显式指定格式化标记。 WebStorm 使用指定的正则表达式而不是精确字符串来匹配格式器的启用/禁用标记。

例如,使用正则表达式可以定义多个启用与禁用格式器的标记。 在这种情况下,您可以使用以下正则表达式: @formatter:(off|disable|no)@formatter:(on|enable|yes)

请参阅 使用格式化标记的示例 ,以查看演示。

使用格式化标记的示例

该示例显示了两个代码片段。 其中一个 line 72 - line 76 被包含在 @formatter :off@formatter:on 标记内,而另一个 line 78 - line 81 未被包含。

原始格式:

格式化标记

位于标记 (line 72 - line 76) 内的代码保持原始格式,而未被标记 (line 78 - line 81) 包含的代码将被重新格式化:

格式化标记已启用

两个代码片段的原始格式均未保留:

格式化标记已关闭
最后修改日期: 2025年 9月 26日