PyCharm 2025.3 Help

代码风格。 HTML

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

制表符与缩进

使用制表符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新格式化代码

  • 清除此复选框后,PyCharm 将使用空格而非制表符。

智能制表符

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

  • 选中此复选框后,嵌套产生的部分可同时使用制表符和空格(如有必要),而由对齐决定的部分仅使用空格。

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

制表符大小

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

缩进

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

续行缩进

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

在空行上保留缩进

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

其他

说明

右边距

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

输入时换行

使用这些设置指定正在编辑的文本如何适配指定的 右边距

您可以选择以下选项之一:

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

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

  • ——在这种情况下,将关闭此选项,且行可以超过右边距中指定的数值。

保留换行符

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

在文本中保留换行符

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

保留空行

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

属性换行

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

  • 不换行——选择此选项时,不会对代码应用任何特殊换行样式。

  • 过长时换行——选择此选项时,超出右边距的行将按适当的缩进进行换行。

  • 过长时逐项换行——选择此选项时,列表中超出右边距的元素将换行,每行一个元素,并具有适当的缩进。

  • 始终换行——选择此选项时,列表中的所有元素都将换行,每行一个元素,并具有适当的缩进。

文本换行

选中此复选框后,将根据代码风格设置对长行进行换行。

对齐属性

选中此复选框后,将对连续行中的属性进行对齐。

对齐文本

选中此复选框后,PyCharm 会对标签内跨多行的文本进行对齐。

保留空白字符

选中此复选框后,将禁止把实际的空白字符替换为制表符。

空格

在此区域中,定义属性与标签名称的空格用法。

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

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

  • 在空标签中——选中此复选框后,会在空标签中添加空格。

在其前插入新行

此显示字段显示一个标签列表,应在这些标签之前插入新行。 使用字段旁边的按钮 ,或按 Shift+Enter 打开 在标签前插入换行 对话框,您可以在其中编辑标签列表。

在其前移除新行

此显示字段显示一个标签列表,应在这些标签之前移除新行。 使用字段旁边的按钮 ,或按 Shift+Enter 打开 在标签前移除换行 对话框,您可以在其中编辑标签列表。

不缩进以下标签的子元素

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

或当标签大小大于

在此字段中,指定标签的最小行数;当其长度达到该值时,其子元素将不再缩进。

内联元素

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

保留内部空白字符

此显示字段显示一个标签列表,您希望编辑器在这些标签内部保留空白字符 按原样 ,不作任何更改。 使用字段旁边的按钮 ,或按 Shift+Enter 打开 保留内部空白 对话框,您可以在其中编辑标签列表。

若为内联内容则不换行

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

生成的引号

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

这在使用 JavaScript 动态插入 HTML 时很重要,并且您希望始终对 JavaScript 字符串使用双引号、对 HTML 使用单引号,以防止出现问题,例如复制和粘贴时。

在格式化时强制应用

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

排列

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

匹配规则

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

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

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

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

  • - 使用这些按钮将所选规则上移或下移。

空规则

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

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

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

  • 命名空间 - 使用此字段在规则中指定命名空间。 这使您可以指定控制命名空间属性位置的规则。

  • 顺序 - 使用此下拉列表为该规则选择排序顺序。 当多个元素使用同一匹配规则时,此选项非常有用。 在这种情况下,选择 保持顺序 将保留重新排列之前的顺序,选择 按名称排序 将按名称对具有相同匹配规则的元素进行排序。

icon_sort.png

当您在 顺序 列表中选择 按名称排序 时,将显示此图标。 该图标表示此规则中的项按字母顺序排序。

代码生成

在此选项卡中,配置生成代码的代码风格。

注释

在此区域中,配置生成注释的代码风格。

  • 行注释在第一列 :选中此复选框以使行注释从第一列开始。 清除此复选框后,行注释将在代码中对齐。

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

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

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

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

设置来源

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

若要恢复到初始代码风格设置并放弃更改,请点击 重置

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