IntelliJ IDEA 2025.1 Help

代码样式。 Groovy

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

制表符和缩进

条目

描述

使用制表符

请使用 Tab 键进行缩进。 当复选框未勾选时， IntelliJ IDEA 使用空格而非制表符。

智能制表符

  • 如果选中此复选框，则嵌套代码块的缩进将根据需要使用制表符和空格，而对齐缩进则仅使用空格。

  • 如果此复选框未选中，将只使用选项卡。 这意味着一组符合指定制表符大小的空格将自动替换为一个制表符，这可能会导致精细对齐的破坏。

智能制表符 复选框在启用 使用制表符 选项时可用。

制表符大小

在此字段中，指定一个选项卡中包含的空格数。

缩进

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

空行时保持缩进

如果选中此复选框，IntelliJ IDEA 将会保持空行的缩进，就像它们包含了一些代码一样。

如果取消勾选此复选框，IntelliJ IDEA 将删除制表符和空格。

标签缩进

在此字段中，指定在下一行的选项卡语句之前插入的空格数量。

绝对标签缩进

如果选中此复选框，选项卡缩进将被视为绝对空格数。 否则，选项卡缩进将相对于先前的缩进级别进行计数。

空格

使用此选项卡来指定您希望在代码中的哪些位置添加空格。 为了让 IntelliJ IDEA 在某个位置自动插入空格，请在列表中选择这个位置旁边的复选框。 结果将在预览窗格中显示。

包装和大括号

在此选项卡中，自定义代码样式选项，IntelliJ IDEA 将在 重新格式化源代码 时应用。 左侧窗格包含异常列表（重新设置格式时保持 ），以及各种代码结构（列表、语句、操作、注解等）的放置和对齐选项。 右侧窗格显示预览。

对齐设置优先于缩进选项。

在以下位置硬包装

使用 强制换行位置 字段指定元素右侧所需的边距空间。 如果您选择了 默认 选项，那么将使用 全局设置中的右边距值。

输入时自动换行

使用 键入时换行 设置来指定如何将编辑的文本适应到指定的 强制换行位置 中：

  • 默认 ：在这种情况下，IntelliJ IDEA 使用的是 键入时换行 选项，该选项在 全局设置中指定。

  • 是 ：在这个例子中，IntelliJ IDEA 使用了在 右边距 字段里指定的值。

  • 否 ：在这种情况下，此选项被关闭，一行可以超过右侧边距指定的值。

视觉指南

使用 视觉参考线 字段来指定多个右边距。 您可以保留默认值，或者输入您的边距所需的空格数。 如果您想要指定多个边距，请输入由顿号分隔的数字。

在重新格式化时保持

在重新格式化源代码时，使用复选框来配置 IntelliJ IDEA 将要做出的异常。 例如，默认情况下， 换行符 复选框被选中。 如果您的代码包含的行数比标准规范短，您可以在 换行符 多选框前取消选中，然后您再 重新格式化源代码以转换它们。

包装选项

换行样式应用于左侧窗格中指定的各种代码构造（例如，方法调用参数、方法声明参数或赋值语句）。

条目

描述

包装风格

从这个列表中，选择您想要的换行样式：

  • 不换行 ：当选择此选项时，不会应用任何特殊的换行样式。

    选择此选项后，将忽略嵌套对齐和大括号设置。

  • 过长则换行 ：选择此选项可以让超出右边界的行以正确的缩进进行折叠。

  • 始终换行 ：选择此选项以包装所有列表中的元素，使每行只有一个元素，并具有适当的缩进。

  • 如果过长则截断 ：选择此选项可将超出右边距的列表中的元素进行换行，以便每行一个元素并带有适当的缩进。

对齐选项

条目

描述

多行时对齐

如果选中此复选框，代码构造将在每一行的同一列开始。 否则，代码结构的位置由当前的缩进级别确定。

<character(s)> 在下一行

选择此复选框，当行被包装时，将指定的字符或字符移至下一行。

'else' 在新的一行

使用此复选框，将相应的语句或字符移至下一行。

在 <character> 之后换行

选择此复选框，可以将指定字符后的代码移至新行。

特别的 'else if' 处理

如果选中此复选框， else if 语句会位于同一行。

否则， else if 语句将移动到下一行的相应缩进级别。

缩进 'case' 分支

如果选中此复选框， case 语句将位于相应的缩进级别。 否则， case 语句会与 switch 放置在同一缩进级别。

大括号放置选项

条目

描述

大括号放置风格

使用此列表指定 类声明、 方法声明及其他类型声明中左大括号的位置。 可用选项包括：

  • 行尾 ：选择此选项将在声明行末放置开括号。

  • 下一行(如果换行) ：选择此选项，可以在多行声明行之后的行首放置开始大括号。

  • 下一行 ：选择此选项可以在声明行之后的行首放置开括号。

  • 下一行(移位) ：选择此选项将使声明行后的开放大括号换行，并移至相应的缩进级别。

  • 下一行，每次移位 ：选择此选项可以使开括号放在声明行的下一行，并且相应地移到相应的缩进级别，并且将下一行移到下一个缩进级别。

强制使用大括号

从这个列表中，为 if， for， while 和 do () while 语句选择大括号介绍方法。 可用选项包括：

  • 不强制 ：选择此选项以自动阻止引入括号。

  • 当多行时 ：如果语句占用多行，则选择此选项以自动引入括号。 请注意，IntelliJ IDEA 分析的是整个声明中的行数，而非仅其条件。

    IntelliJ IDEA 将自动插入大括号：

  • 始终 ：勾选此复选框以自动始终添加大括号。

空白行

使用此选项卡定义在重新格式化后，您希望 IntelliJ IDEA 保留并在您的代码中插入多少空行以及在何处插入。 对于每种类型的位置，请指定要插入的空行数量。 结果将在预览窗格中显示。

条目

描述

保持最大的空白行

在此区域，指定在指定位置重新格式化后要保留的空行数。

最小的空白行

在此区域，指定在指定位置应存在的空行数量。

导入

这个表格列出了优化导入时需要执行的操作。

条目

描述

常规

在此区域，配置通用导入选项。

选项:

  • 使用单类导入 ：在代码生成或 导入优化过程中，仅导入包中的特定类。 否则，将插入导入整个包的语句。

  • 使用完全限定类名 ：在代码生成或 导入优化期间，使用要导入的类的完全限定名。 否则，将插入一条常规的导入语句。

  • 为内部类插入导入 ：为代码中引用的内部类创建导入。

  • 在 JavaDoc 中使用完全限定名称 ：在 Javadocs 中使用完全限定的类名。 否则，将导入一个类。

  • 使用 '*' 进行导入的类计数 ：请指定从一个包中导入的类的数量，直到所有导入单一类的声明被替换为一个导入整个包的声明。

  • 名称计数以使用静态导入“*” ：在此字段中，指定需要从单个类中导入的成员数量，直到所有导入单个成员的声明被替换为导入整个类的声明。

JSP 导入布局

在此区域中，配置您的代码中 JSP 导入语句应如何组织。 引入的更改将在下面的 预览 面板中显示。

选项:

  • 优先选择逗号分隔的导入列表 ：选择此选项可以将语句组织为逗号分隔的列表。

  • 每页指令优先使用一个导入语句 ：选择此选项可为每行创建一个导入语句。

使用 '*' 导入的包

在此区域中，配置一份始终完整导入的包和类的列表。

选项:

  • Static ：如果您想为所选类声明 static 导入，请选择此复选框。

  • Package ：在此列的文本字段中，指定始终完全导入的包和类。

    请注意，IntelliJ IDEA 会在您输入完毕后自动在包名的末尾添加 .*。

  • 选择子包 ：勾选此复选框将完全导入所选包的所有子包。

  • 添加包 ：点击此按钮以在包和类的列表中添加新条目。

  • 添加空格 ：点击此按钮在包和类的列表中添加一个空的分隔符。

  • 删除 ：点击此按钮以从列表中删除所选的包或类。

导入布局

在此区域，配置您的代码中应如何组织 import 语句。 您可以设置某些类别，使其被放置在最前方，或者最后，或者依次排列。 导入的类将按照其包进行分组，并在包内按字母顺序排序。

选项:

  • 单独排列静态导入 ：如果勾选此复选框，所有静态导入将会保持在一个独立的部分中。 否则，所有的导入声明将按照指定的布局规则进行排序。

  • Static ：如果您想为所选包声明静态导入，请选择此复选框。

  • Package ：在此列的文本字段中，指定要导入的包。

  • 带有子包 ：选中此复选框，IntelliJ IDEA 将对所选包的所有子包应用布局规则。

  • 添加包 ：点击此按钮，向包列表中添加新条目。

  • 添加空白 ：点击此按钮，在选定的条目后插入一个空行，这表示应在相应的导入语句之间插入一个空行。

  • 向上移动 / 向下移动 ：点击这些按钮，可以在列表中上下移动包或空行，从而定义导入语句的顺序。

  • 移除 ：点击此按钮以从列表中删除所选包。

代码生成

条目

描述

成员顺序

使用此区域配置您的代码成员的排序层次结构。 您可以使用 将列表项上移 或 将列表项向下移动 箭头键将列表项上移或下移。

注释代码

在此区域配置生成注释的代码样式（行 Ctrl+/ 和块 Ctrl+Shift+/）：

  • 行注释在第一列 ：在第一列开始行注释（Ctrl+/）。 如果您禁用此选项，注释将与您的代码对齐。

  • 在注释开头添加一个空格 ：在行注释字符和被注释行的第一个字符之间插入一个空格。

  • 重新设置格式时强制 ：在现有评论中，当您正在 重新格式化代码时，将空格插入行注释字符和被注释行的第一个字符之间。 请注意，第一个字符必须是字母数字符号，否则不会插入空格。 例如，reformatter 将会忽略 //&Lorem ipsum 的评论。

    当 在注释开头添加一个空格 被启动时，此选项变为可用。

  • 注释块在第一列 ：在第一列开始块注释（Ctrl+Shift+/）。 如果您禁用此选项，注释将与您的代码对齐。

  • 在块注释周围添加空格 ：在块注释字符和被注释文本的第一个字符之间插入一个空格。

设置自...

点击此链接，显示用作当前语言代码样式基础的语言列表。 只有适用于当前语言的设置才会被采用。 所有其他设置均不受影响。

此链接会在适用时出现在语言特定代码样式页面的右上角。

点击 重置 以放弃更改并返回至初始的代码样式设置。

最后修改日期： 2025年 4月 24日
代码样式。 Dart代码样式。 GSP