PyCharm 2025.3 Help

代码样式:Vue 模板

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

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

制表符与缩进

与块中语言相关

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

在整个文件中相同

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

使用制表符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新设置代码格式

  • 如果清除此复选框,PyCharm 将使用空格替代制表符。

智能制表符

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

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

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

制表符大小

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

缩进

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

延续缩进

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

在空行上保留缩进

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

缩进顶级标签的子元素

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

空格

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

换行与大括号

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

视觉指南

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

插值

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

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

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

换行选项

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

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

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

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

  • 若过长则逐个换行 - 选择此选项可将超过右边距的列表元素换行,使每行一个元素,并使用正确缩进。

排列

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

匹配规则

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

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

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

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

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

空规则

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

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

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

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

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

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

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

按字母顺序排序按钮

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

设置来源

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

要返回初始的代码样式设置并放弃更改,请点击 重置

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