WebStorm 2025.2 Help

代码样式。 XML

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

制表符和缩进

使用制表符字符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新格式化代码

  • 如果未选中该复选框,WebStorm 将使用空格代替制表符。

智能制表符

一个缩进包含两个部分。 一部分由代码块嵌套产生,另一部分由对齐方式决定。

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

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

制表符大小

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

缩进

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

续行缩进

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

保留空行缩进

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

其他

项目

描述

右边距

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

输入时自动换行

使用这些设置来指定如何在指定的 右边距 中适配编辑文本。 您可以选择以下选项之一:

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

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

  • —— 在此情况下,该选项关闭,文本行可超出右边距所指定的数字。

保留换行符

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

在文本中保留换行符

选中此复选框时,WebStorm 会在编辑器中查看 XML 文件时保留属性(例如较长说明)中的换行符。

保留空行

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

属性换行

使用此列表确定属性行的换行方式。 可用选项包括:

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

  • 如过长则换行—— 选择此选项,在超过右边距的情况下换行,并保持正确缩进。

  • 如过长则拆分—— 选择此选项,在列表中元素超出右边距时将其换行为每行一个元素,并保持正确缩进。

  • 始终换行—— 选择此选项,将列表中的所有元素换行为每行一个元素,并保持正确缩进。

文本换行

选中此复选框时,长文本行会根据代码样式设置进行换行。

属性对齐

选中此复选框时,执行属性对齐,使连续行上的属性保持对齐。

保留空格

选中此复选框时,编辑器会保留标签内的所有空格字符。 这同样适用于缩进和换行符。

空格

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

  • 属性中“=”周围 :选中此复选框,在属性的“=”符号周围添加空格。

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

  • 空标签中 :选中此复选框,在空标签中添加空格。

CDATA

在此区域中,定义 MXML 文件中 CDATA 区块周围及内部的空格使用方式:

  • 周围的空格 :从列表中选择如何处理 CDATA 周围的空格。

    • 保留 :重新格式化后将保留所有空格。

    • 移除(保留标签) :将移除 CDATA 周围的所有空格,并保留标签在同一行。

    • 换行 :将在 CDATA 前后添加换行符。

  • 保留内部空格 :如选中此复选框,将保留 CDATA[ 之后以及 ]] 之前的空格。

排列顺序

使用 匹配规则 区域定义规则列表及其顺序。

添加规则按钮

添加新规则。

移除规则按钮

从列表中移除所选规则。

编辑规则按钮

编辑所选规则。

上移按钮下移按钮

更改列表中规则的顺序。

每条规则都可以匹配以下内容:

  • 类型 :仅匹配标签或属性。 双击某一类型以禁用筛选并匹配两者。

  • 名称 :匹配元素的完整名称。 该筛选器支持正则表达式,并使用 标准语法

  • 命名空间 :匹配命名空间属性。

  • 顺序 :选择如何排序匹配相同规则的多个元素。 例如,如果存在多个同名属性,可选择 保持排序 按相同顺序排列,或选择 按名称排序 按属性值的字母顺序排序。 按字母顺序排序的规则将以 按字母排序图标 表示。

使用 强制重新排列 列表,在重新格式化代码时选择默认的重新排列行为。 这将定义 重新设置代码格式 对话框中 重新排序条目(R) 复选框的默认状态。

  • 使用当前模式(可在“重新格式化代码”对话框中切换) :默认启用 重新排序条目(R) 复选框,但您可以更改该设置。

  • 始终 :默认启用 重新排序条目(R) 复选框,且无法更改。

  • 从不 :默认禁用 重新排序条目(R) 复选框,且无法更改。

设置来源

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

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

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