GoLand 2025.2 Help

代码样式。 HTML

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

制表符和缩进

使用 Tab 字符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于代码重排

  • 如果清除此复选框,GoLand 将使用空格代替 Tab。

智能 Tab

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

  • 选中此复选框后,由嵌套产生的部分将包含 Tab 和空格(如有必要),而对齐部分仅包含空格。

  • 如果清除此复选框,则仅使用 Tab。这意味着在重新格式化后,符合指定 Tab 大小的一组空格将自动替换为 Tab,可能会造成细节对齐被破坏。 这意味着在重新格式化后,符合指定 Tab 大小的一组空格将自动替换为 Tab,可能会造成细节对齐被破坏。

Tab 大小

在此字段中指定一个 Tab 所对应的空格数量。

缩进

在此字段中指定每一级缩进应插入的空格数量。

续行缩进

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

保留空行的缩进

选中此复选框后,GoLand 将保留空行的缩进,就如同其中包含代码一样。 如果清除此复选框,GoLand 将删除空行上的 Tab 字符和空格。

其他

项目

描述

右边距

使用这些设置指定元素右侧所需的边距空间。 如果选择了 默认 选项,则将使用 全局设置 中的右边距值。

输入时自动换行

使用这些设置指定编辑文本如何适应所设定的 右边距

您可以选择以下其中一种选项:

  • 默认 — 在这种情况下,GoLand 使用 输入时换行 选项,该选项在 全局设置 中指定。

  • — 在这种情况下,将使用设定的右边距中的值。

  • — 在这种情况下,此选项已关闭,单行可以超过设定的右边距值。

保留换行符

选中此复选框后,GoLand 在编辑器中查看 HTML 文件时将保留换行符。

保留文本中的换行符

选中此复选框后,GoLand 在编辑器中查看 HTML 文件时,将保留属性中的换行符(如长描述)。

保留空行

在此字段中指定重新格式化后应保留的最小连续空行数。

换行属性

使用此下拉列表确定属性行应如何换行。 可用的选项有:

  • 不换行 — 如果选择此选项,则不会对代码应用特定换行样式。

  • 超长时换行 — 选择此选项,使超出右边距的行自动按照正确缩进方式换行。

  • 超长时分行 — 选择此选项,使列表中超出右边距的元素按每行一个元素的方式换行,并使用适当缩进。

  • 始终换行 — 选择此选项,使列表中所有元素按每行一个元素的方式换行,并使用适当缩进。

换行文本

选中此复选框后,长行将根据代码样式设置进行换行。

对齐属性

选中此复选框后,会对顺序行中的属性进行对齐。

对齐文本

选中此复选框以使 GoLand 对标签中占据多行的文本进行对齐。

保留空格

选中此复选框以阻止将实际空格替换为制表符。

空格

在此区域中定义属性和标签名称的空格使用方式。

  • 属性中的 "=" 两侧 — 选中此复选框以在属性中的 "=" 符号两侧添加空格。

  • 标签名称后 — 选中此复选框以在标签名称之后添加空格。

  • 空标签中 — 选中此复选框以在空标签中添加空格。

在其前插入新行

此显示字段显示应在其前插入新行的标签列表。 使用字段旁的按钮 ,或按 Shift+Enter 打开 在标签前插入新行 对话框,在此处可以编辑标签列表。

在其前删除换行符

此显示字段显示应在其前移除换行的标签列表。 使用字段旁的按钮 ,或按 Shift+Enter 打开 删除标签前的换行符 对话框,在此处可以编辑标签列表。

不缩进其子项

此显示字段显示其子元素不应缩进的标签列表。 使用字段旁的按钮 ,或按 Shift+Enter 打开 不缩进以下元素的子元素 对话框,在此处可以编辑标签列表。

或如果标签行数超过

在此字段中指定标签的最小行数,超过此行数时其子项不再缩进。

内联元素

此显示字段显示在源代码中与其他标签位于同一行的标签列表。 如果某个标签从列表中移除,在将其添加至源代码时,编辑器会自动将其移至新行。 使用字段旁的按钮 ,或按 Shift+Enter 打开 内联元素 对话框,在此处可以编辑标签列表。

保留内部空格

此显示字段显示包含在其中时,编辑器应保留空格 原样 不更改的标签列表。 使用字段旁的按钮 ,或按 Shift+Enter 打开 保留内部空格 对话框,在此处可以编辑标签列表。

如果为内联内容则不换行

此显示字段显示在其内容为内联时不应换行的标签列表。 使用字段旁的按钮 ,或按 Shift+Enter 打开 仅包含内联内容时不换行 对话框,在此处可以编辑标签列表。

生成的引号

在输入 = 时,选择要自动插入在 HTML 属性周围的引号样式(双引号、单引号或无)。

当使用 JavaScript 动态插入 HTML 且希望一致地为 JavaScript 字符串使用双引号、为 HTML 使用单引号以避免问题(例如复制和粘贴)时,这一点尤为重要。

格式化时强制应用

如果选中此复选框,则在 代码重新格式化时,会替换先前生成的引号(例如,用单引号替换双引号)。

排列

在此选项卡中,定义一组规则以根据您的偏好重新排列 HTML 代码。

匹配规则

使用此区域将元素顺序定义为规则列表,其中每条规则都包含一组匹配项,例如修饰符或类型。

  • — 使用此按钮添加规则。 空规则 区域将打开。

  • — 使用此按钮从列表中移除规则。

  • — 使用此按钮编辑现有规则。 要查看此按钮,请导航到要编辑的规则并点击该按钮。 在弹出的窗口中修改规则字段。

  • — 使用这些按钮上下移动所选规则。

空规则

使用此区域创建新的匹配规则或编辑现有规则。 您可以从以下筛选器中进行选择:

  • 类型 — 使用此筛选器为规则选择标签或属性。 请注意,双击类型关键字将否定该条件。

  • 名称 — 使用此字段在规则中指定条目名称。 此筛选器仅匹配条目名称,例如标签名称或属性名称。 该筛选器支持正则表达式,并使用 标准语法。 匹配是在整个名称上执行的。

  • 命名空间 :使用该字段在规则中指定命名空间。 它允许您指定一个控制命名空间属性位置的规则。

  • 顺序 :使用此下拉列表为规则选择排序顺序。 当多个元素使用相同的匹配规则时,该选项非常有用。 在这种情况下,选择 Keep order 将保留重新排列前设定的顺序,选择 Order by Name 将按名称对使用相同匹配规则的元素进行排序。

icon_sort.png

当您从 顺序 列表中选择 Order by Name 时,将显示此图标。 该图标表示此规则中的项目按字母顺序排序。

代码生成

在此选项卡中配置生成代码的代码样式。

注释

在此区域中配置生成注释的代码样式。

  • 行注释在第一列 :选中此复选框可使行注释从第一列开始。 取消选中该复选框时,行注释将在代码中对齐。

    第一列的行注释已清除
    第一列的行注释已选中
  • 注释块在第一列 :默认情况下,此复选框处于未选中状态,块注释在代码中对齐。 选中此复选框可使块注释从第一列开始。

    第一列的块注释已关闭
    第一列的块注释已开启
  • 在块注释周围添加空格 :选中此复选框可在块注释中添加前导和尾随空格。

    默认情况下,当您将代码片段包含在块注释中时,文本紧随起始 <!-- 字符之后开始,前面不带空格。 在结束 --> 字符前也不会插入空格。 此默认代码样式可能与某些 linter 规则(例如 ESLint)冲突。

    块注释起始处未添加空格
    块注释起始处已添加空格

设置来源

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

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

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