PyCharm 2026.1 Help

代码样式:Vue 模板

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

指定哪些顶级标签的内容应缩进,默认情况下,仅对 template 标签内的代码应用缩进。 此外,确定缩进是对所有顶级标签统一,还是依赖所用语言(例如针对 HTML 或 Pug 的特定样式)。

制表符和缩进

特定于块中语言

选择此选项可按语言特定样式缩进顶级标签的内容。

在整个文件中相同

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

使用制表符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新格式化代码

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

智能制表符

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

  • 选中此复选框时,源自嵌套的那一部分可同时包含制表符和空格(如有必要),而由对齐定义的那一部分仅由空格组成。

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

制表符大小

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

缩进

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

续行缩进

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

在空行保留缩进

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

缩进顶层标签的子元素

默认情况下,只有 template 标签内的代码具有初始缩进。 如有必要,请使用逗号作为分隔符添加其他标签。 例如,如果您在该字段中指定 script ,则所有 script 标签内的代码都会获得初始缩进,如 预览 窗格所示。

空格

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

换行和大括号

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

视觉引导线

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

插值

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

如果 Vue.js 插值中的 JavaScript 表达式包含换行,PyCharm 会自动从新行开始该 JavaScript 表达式,并在其后添加新行。

清除 在 '{{' 之后换行在 '}}' 之前换行 复选框以更改此默认行为。

换行选项

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

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

  • 超出右边距时换行 - 选择此选项可对超过右边距的行进行换行,并使用适当的缩进。

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

  • 过长时分行 - 选择此选项可对列表中超过右边距的元素进行换行,使每行一个元素,并使用适当的缩进。

排列

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

匹配规则

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

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

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

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

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

空规则

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

  • 按类型分组 :使用此过滤器为规则选择标签或属性。

    请注意,连续点击某个类型关键字两次会对该条件取反。

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

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

  • 顺序 :使用此列表选择该规则的排序顺序。 当多个元素使用相同的匹配规则时,此选项很有用。 在这种情况下,选择 Keep order 将保持与重新排列之前相同的顺序,选择 Order by Name 将按名称对具有相同匹配规则的元素排序。

  • 别名 :此选项显示在 规则别名定义 对话框中定义的别名。 您可以移除不需要的别名。

按字母顺序排序按钮

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

设置来源

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

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

2026年 3月 24日