IntelliJ IDEA
 
2023.2
快捷方式：Windows
获取 IntelliJ IDEA
  1. 参考
  2. 设置
  3. 编辑
  4. 代码风格
  5. Groovy

代码风格。Groovy

最后修改时间：2022 年 3 月 17 日

文件| 设置 | 编辑| 代码风格| 适用于 Windows 和 Linux 的Groovy

IntelliJ IDEA | 设置 | 编辑| 代码风格| 适用于 macOS 的Groovy

CtrlAlt0S 设置图标

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

制表符和缩进

物品

描述

使用制表符

  • 如果选中此复选框，则使用制表符：

    • 按下按键时Tab

    • 用于缩进

    • 用于代码重新格式化

  • 清除该复选框后，IntelliJ IDEA 使用空格而不是制表符。

智能标签

  • 如果选中此复选框，则由代码块嵌套定义的缩进部分由制表符和（如果需要）空格组成，而由对齐定义的缩进部分仅由空格组成。

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

如果选择使用制表符复选框，则智能制表符复选框可用。

标签尺寸

在此字段中，指定制表符中包含的空格数。

缩进

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

在空行上保留缩进

如果选中此复选框，IntelliJ IDEA 将在空行上保留缩进，就好像它们包含某些代码一样。

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

标签缩进

在此字段中，指定要在标签语句之前的下一行插入的空格数。

绝对标签缩进

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

空间

使用此选项卡可以指定代码中需要空格的位置。要让 IntelliJ IDEA 自动在某个位置插入空格，请选中列表中该位置旁边的复选框。结果显示在预览窗格中。

包裹和大括号

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

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

硬包装在

使用硬换行字段指定元素右侧所需的边距空间。如果选择“默认”选项，则使用全局设置中的右边距值。

打字时换行

使用打字时换行设置来指定编辑的文本如何适合指定的硬换行：

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

  • 是：在这种情况下，IntelliJ IDEA 使用“右边距”字段中指定的值。

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

视觉指南

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

重新格式化时保留

使用复选框配置 IntelliJ IDEA 在重新格式化源代码时将发生的异常。例如，默认情况下，“换行符”复选框处于选中状态。如果您的代码包含比标准约定短的行，您可以在重新格式化源代码之前通过禁用换行符复选框来转换它们。

包装选项

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

物品

描述

包裹方式

从此列表中选择所需的环绕样式：

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

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

  • 如果太长则换行：选择此选项可以使用适当的缩进将超出右页边距的行换行。

  • 始终换行：选择此选项可使列表中的所有元素换行，以便每行有一个元素具有正确的缩进。

  • 如果长则砍掉：选择此选项可以将列表中超出右边界的元素换行，以便每行有一个元素具有适当的缩进。

对齐选项

物品

描述

多行时对齐

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

<character(s)>在下一行

选中此复选框可在换行时将指定的一个或多个字符移动到下一行。

新行上的“其他”

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

之后的新行<character>

选中此复选框可将指定字符后面的代码移至新行。

特殊的“else if”处理

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

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

缩进“case”分支

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

牙套放置选项

物品

描述

牙套放置方式

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

  • 行尾：选择此选项可将左大括号放置在声明行末端。

  • 下一行（如果换行）：选择此选项可将左大括号放置在多行声明行之后的行开头。

  • 下一行：选择此选项可将左大括号放置在声明行之后的行开头。

  • 下一行移动：选择此选项可将左大括号放置在声明行移动到相应缩进级别之后的行处。

  • 下一行，每次移动：选择此选项可将左大括号放置在声明行移动到相应缩进级别之后的行，并且下一行也移动到下一个缩进级别。

力支撑

从此列表中，选择if、for、while和do () while语句的大括号引入方法。可用的选项有：

  • 不强制：选择此选项可禁止自动引入大括号。

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

    IntelliJ IDEA 将自动插入大括号：

  • 始终：选择此复选框可始终自动引入大括号。

空行

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

物品

描述

保留最大空白行

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

最少空白行

在此区域中，指定指定位置中出现的空行数。

警告

这些设置不会影响第一个项目之前和最后一个项目之后的空行数。

进口

此表列出了优化导入时要执行的操作。

物品

描述

一般的

在此区域中，配置常规导入选项。

选项：

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

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

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

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

  • 使用 import with '*' 的类计数：指定要从单个包导入的类的数量，直到导入单个类的所有语句都替换为导入整个包的语句。

  • 名称计数使用带有 '*' 的静态导入：在此字段中，指定要从单个类导入的成员数量，直到导入单个成员的所有语句都替换为导入整个类的语句。

JSP 导入布局

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

选项：

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

  • 首选每页一条导入语句指令：选择此选项可在每行创建一条导入语句。

使用带“*”导入的包

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

选项：

  • 静态：如果要声明所选类的静态导入，请选择此复选框。

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

    请注意，输入完成后，IntelliJ IDEA 会自动添加到.*包名称的末尾。

  • 使用子包：选中此复选框可完全导入所选包的所有子包。

  • 添加包：单击此按钮可将新条目添加到包和类列表中。

  • 添加空白：单击此按钮可将空分隔符添加到包和类列表中。

  • 删除：单击此按钮可从列表中删除选定的包或类。

导入布局

在此区域中，配置导入语句在代码中的组织方式。您可以将某些类设置为第一个、最后一个或一个接着一个。导入的类将根据其包进行分组，并在包内按字母顺序排序。

选项：

  • 单独布局静态导入：如果选中此复选框，则所有静态导入将保留在单独的部分中。否则，所有导入语句将根据指定的布局规则进行排序。

  • 静态：如果要声明所选包的静态导入，请选择此复选框。

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

  • With Subpackages：选择此复选框以使 IntelliJ IDEA 将布局规则应用到所选包的所有子包。

  • 添加包：单击此按钮可将新条目添加到包列表中。

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

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

  • 删除：单击此按钮可从列表中删除选定的包。

代码生成

物品

描述

会员顺序

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

评论代码

使用此区域配置生成注释的代码样式（行和块）：Ctrl0/CtrlShift0/

  • 第一列行注释：在第一列开始行注释 ( )。如果禁用该选项，注释将与您的代码保持一致。Ctrl0/

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

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

    当启用在评论开始处添加空格时，此选项可用。

  • 第一列块注释：在第一列开始块注释 ( )。如果禁用该选项，注释将与您的代码保持一致。CtrlShift0/

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

设置从...

单击此链接可显示用作当前语言代码样式基础的语言列表。仅采用适用于当前语言的设置。所有其他设置不受影响。

如果适用，此链接将显示在特定于语言的代码样式页面的右上角。

单击“重置”放弃更改并返回到初始的代码样式设置集。

也可以看看

特定于语言和框架的指南