WebStorm 2025.2 Help

代码样式。 JSON

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

制表符与缩进

使用制表符字符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新格式化代码

  • 取消选中此复选框后,WebStorm 将使用空格替代制表符。

智能制表符

缩进由两个部分组成。 一部分由代码块嵌套产生,另一部分由对齐确定。

  • 选中此复选框后,由嵌套产生的部分将包含制表符和必要时的空格,而由对齐确定的部分仅由空格组成。

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

制表符大小

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

缩进

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

继续缩进

此字段中指定在数组元素、表达式、方法声明和方法调用之间插入的空格数。

在空行保留缩进

选中此复选框后,WebStorm 会在空行上保留缩进,就像包含了某些代码一样。取消复选框后,WebStorm 会删除空行上的制表符和空格。 取消复选框后,WebStorm 会删除空行上的制表符和空格。

空格

使用此选项卡指定 WebStorm 自动插入空格的位置。 选中对应位置描述旁的复选框,在 预览 面板中查看结果。

换行与大括号

在此选项卡中自定义异常情况、大括号放置和对齐选项,WebStorm 将在 重新格式化源代码时应用于各种代码结构。 在 预览 面板中查看结果。

强制换行位置

在此字段中,指定元素右侧所需的空格数。 若接受 默认 选项,则使用 全局设置 中的值。

键入时换行

此字段中指定编辑后的文本如何适配指定的 强制换行位置 字段。

  • 默认 :选择此选项以使用 键入时换行 字段中的 全局设置 值。

  • :选择此选项以使用 右边距 字段中的值。

  • :选择此选项后,代码行可超出右边距指定的数值。

视觉参考线

此字段中指定多个右边距。您可以保留默认值或输入空格数来设置边距。若需指定多个边距,请输入以逗号分隔的数字。 您可以保留默认值或输入空格数来设置边距。 若需指定多个边距,请输入以逗号分隔的数字。

重新格式化时保留

使用这些复选框配置 WebStorm 在重新设置源代码格式时要保留的例外。 例如,默认情况下已选中 换行 复选框。

如果代码包含短于标准约定的行,可在重新格式化前取消选中 换行 复选框以进行转换。

换行选项

换行样式适用于左侧面板中指定的各种代码结构(例如,方法调用参数或赋值语句)。

  • 不换行 :选择此选项后,不应用特殊的换行样式,将忽略嵌套对齐和大括号设置。

  • 超过时换行 :选择此选项可将超出右边距的代码行按正确缩进方式换行。

  • 始终换行 :选择此选项可使列表中每个元素单独占一行,并具备正确的缩进。

  • 超过时拆分 :选择此选项可将超出右边距的列表元素单独占行,并具备正确的缩进。

  • 确保不超过右边距 :若选中此复选框,格式器将尽可能避免文档行超出右边距。 此选项优先于 不换行 的换行样式。

对齐选项

  • 对象 :从列表中选择对象的对齐方式:

    • 不对齐 :连续行中的属性不会对齐。

    • 冒号对齐 :连续行中的属性将以冒号对齐。

    • 值对齐 :连续行中的属性将以值对齐。

空行

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

最大保留空行数

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

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