WebStorm 2025.2 Help

代码样式:Vue 模板

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

指定哪些顶级标签应具有缩进,其默认行为仅为对 template 标签内的代码使用缩进。 还可以决定是对所有顶级标签使用统一缩进,还是根据使用的语言(例如 HTML 或特定于 Pug)来决定。

制表符和缩进

特定于块中的语言

选择此选项以使用特定于语言的样式为顶级标签内容设置缩进。

整个文件中统一

选择此选项可对文件中所有顶级标签内的代码使用统一缩进。 使用下方的控件配置统一缩进。

使用制表符字符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于代码重新格式化

  • 清除此复选框后,WebStorm 将使用空格而不是制表符。

智能制表符

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

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

  • 清除此复选框后,将仅使用制表符。 这意味着在重新格式化后,符合指定制表符宽度的一组空格会被自动替换为制表符,可能会导致精细对齐被打破。

制表符宽度

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

缩进

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

续行缩进

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

保留空行缩进

选中此复选框时,WebStorm 会保留空行中的缩进,仿佛这些行中包含某些代码。 清除此复选框后,WebStorm 会删除空行中的制表符和空格。

缩进顶级标签的子级

默认情况下,仅 template 标签中的代码具有初始缩进。 如有必要,使用逗号分隔添加其他标签。 例如,如果在字段中指定了 script ,则所有 script 标签中的代码将获得初始缩进,如 预览 窗格所示。

空格

使用此选项卡指定 WebStorm 自动插入空格的位置。 选中相关位置描述旁边的复选框,并在 预览 窗格中查看结果。

换行和大括号

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

可视化参考线

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

插值表达式

在此区域中,为 插值表达式 选择换行样式,并指定是否希望将括号 {{ }} 放在新行(默认)中。

如果 Vue.js 插值表达式中的 JavaScript 表达式 中包含换行符,WebStorm 会自动将该表达式起始位置放在新行中,并在其后添加新行。

取消选中 在 '{{' 后换行在 '}}' 前换行 复选框以更改此默认行为。

换行选项

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

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

  • 若过长则换行 - 选择此选项可对超过右边距的行使用正确缩进进行换行。

  • 始终换行 - 选中此选项可将列表中的所有元素换行,每行一个元素,并正确缩进。

  • 过长时拆分为多行 - 选中此选项可将超出右边距的列表元素换行,每行一个元素,并正确缩进。

排列

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

匹配规则

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

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

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

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

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

空规则

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

  • 类型 :使用此筛选器为规则选择标签或属性。

    请注意,双击类型关键字将取消该条件。

  • 名称 :使用此字段在规则中指定条目名称。 此筛选器仅匹配条目名称,例如字段名称、方法名称、类名称等。 该筛选器支持正则表达式,并使用 标准语法。 匹配将应用于整个名称。

  • 命名空间 :使用此字段在规则中指定命名空间。 此功能允许您指定控制命名空间属性位置的规则。

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

按字母顺序排序按钮

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

设置来源

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

要还原初始代码样式设置并放弃更改,请点击 重置

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