代码风格。爪哇

制表符和缩进

物品	描述
使用制表符	如果选中此复选框，则使用制表符：按下按键时`Tab` 用于缩进用于代码重新格式化清除该复选框后，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 将自动插入大括号：
始终：选择此复选框可始终自动引入大括号。

链式方法调用

物品	描述
结束第一个通话	允许将第一个方法调用包装在链式方法中。
多行时对齐	对齐多个方法调用。
构建器方法	指定要被视为构建器方法的方法的逗号分隔名称（标识符）。例如：`withTitle,withYear,addAuthor,withName,withLastName,end,build`
保持构建器方法缩进	在重新格式化代码时，保持手动插入的其他缩进完好无损。

空行

物品

描述

保留最大空白行

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

最少空白行

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

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

Java文档

物品	描述
结盟	在此区域中，定义 Javadoc 注释的对齐方式。对齐参数描述：选中此复选框可使参数描述与最长的参数名称对齐。否则，说明与相应的参数名称之间用一个空格分隔。对齐抛出的异常描述：选择此复选框可将抛出的异常描述与最长的异常名称对齐。否则，描述与异常名称之间用一个空格分隔。
空行	在此区域中，定义应在 Javadoc 注释中插入空行的位置。描述之后：选择此复选框可在 Javadoc 注释的描述部分之后自动插入一个空行。参数说明之后：选择此复选框可在标签组之后插入一个空行`@param`。返回标签后：选中此复选框可在标签后插入一个空行`@return`。
无效标签	在此区域中，定义是否应保留无效标签。保留无效标签：选中此复选框可保留`@invalidTag`。保留空 @param 标签：选择此复选框可保留`@param`不保留描述的标签。保留空@return 标签：选中此复选框可保留`@return`不保留描述的标签。保留空@throws 标签：选择此复选框可保留`@throws`不保留描述的标签。
其他	在此区域中，指定 Javadoc 注释的附加格式选项。启用前导星号：Javadoc 注释的每一行都以星号开始。使用 @throws 而不是 @exception：使用`@throws`标签。右边距换行：将超出右边距的文本换行到下一行。在空行上生成“<p>”：自动`</p>`在空行上插入标签。保留空行：选中此复选框可保留手动添加的空行。不要换行注释：将简短的注释保留在一行上，并带有开始和结束标记。保留换行符：如果未选中此复选框（默认情况下），则重新格式化时不会保留换行符。当注释应在段落边界内格式化以占用最小空间时，这很方便。如果选中此复选框，将保留换行。参数说明换行：将 Javadoc 参数的说明（如果有）放在新行中。它使用基于连续缩进值的缩进。缩进连续行：缩进多行注释中的后续行。

安排

物品	描述
分组规则	使用此区域设置分组规则。将 getter 和 setter 放在一起选中此复选框可将 getter 和 setter 方法保留在一起。默认情况下，此复选框处于选中状态。将重写的方法放在一起选中此复选框可按类和接口将重写的方法分组在一起。在订单列表中，选择保留订单或按名称排序选项。将依赖方法放在一起选中此复选框可将相关方法分组在一起。在顺序列表中，选择深度优先顺序或广度优先顺序选项。前者会按照嵌套层次来排列方法；后者会将同一嵌套级别的同级方法组合在一起。深度优先 `class foo { public function parent() { $this->child1(); $this->child2(); } private function child1() { $this->nested1(); } private function nested1() { $this->nested2(); } private function nested2() { } private function child2() { } }` 广度优先 `class foo { public function parent() { $this->child1(); $this->child2(); } private function child1() { $this->nested1(); } private function child2() { } private function nested1() { $this->nested2(); } private function nested2() { } }`
匹配规则	使用此区域将元素顺序定义为规则列表，其中每个规则都有一组匹配项，例如修饰符或类型。：使用此按钮添加规则。空的规则区域打开。：使用此按钮添加区域规则。部分规则允许您将方法或变量移动到您定义的部分中。例如，您可以创建以下部分规则：排列后，类中的方法将按照创建的节规则中的指定重新排列，并被注释包围： `//methods start public void test() {} private int a() { return 1; } static void r() {} //methods end` ：使用此按钮从列表中删除规则。：使用此按钮编辑现有规则。要查看此按钮，请导航到要编辑的规则并单击该按钮。在打开的弹出窗口中，修改规则字段。：使用这些按钮向上或向下移动选定的规则。：使用该按钮为匹配规则配置别名。在这种情况下，当您创建排列规则时，您可以定义一个自定义规则（别名），其中包含一系列不同的规则，并将别名应用于当前规则。
空规则	使用此区域可以创建新的匹配规则或编辑现有规则。您可以从以下过滤器中进行选择：类型：使用此过滤器为您的规则选择类或方法。请注意，单击类型关键字两次会否定条件。修饰符：使用此过滤器可以选择规则的修饰符类型。请注意，单击修饰符关键字两次会否定该条件。名称：使用此字段指定规则中的条目名称。此过滤器仅匹配条目名称，例如字段名称、方法名称、类名称等。该过滤器支持正则表达式并使用标准语法。匹配是针对整个名称进行的。顺序：使用此列表选择规则的排序顺序。当多个元素使用相同的匹配规则时，此选项非常有用。在这种情况下，选择“保持顺序”将保持与重新排列之前设置的顺序相同，选择“按名称排序”将按名称对具有相同匹配规则的元素进行排序。别名：此选项显示在“规则别名定义”对话框中定义的别名。您可以删除不需要的。
	当您从“订单”列表中选择“按名称排序”时，会出现此图标。图标表示此规则中的项目按字母顺序排序。

进口

物品	描述
一般的	在此区域中，配置常规导入选项。选项：使用单个类导入：在代码生成或导入优化期间仅导入包中的特定类。否则，将插入导入整个包的语句。使用完全限定的类名称：在代码生成或导入优化期间使用要导入的类的完全限定名称。否则，将插入正常的导入语句。插入内部类的导入：为代码中引用的内部类创建导入。在 JavaDoc 中使用完全限定名称：在 Javadoc 中使用完全限定类名称。否则，将导入一个类。使用 import with '' 的类计数：指定要从单个包导入的类的数量，直到导入单个类的所有语句都替换为导入整个包的语句。名称计数使用带有 '' 的静态导入：在此字段中，指定要从单个类导入的成员数量，直到导入单个成员的所有语句都替换为导入整个类的语句。
JSP 导入布局	在此区域中，配置应如何在代码中组织 JSP 导入语句。引入的更改显示在下面的预览窗格中。选项：首选逗号分隔导入列表：选择此选项可导入以逗号分隔列表组织的语句。首选每页一条导入语句指令：选择此选项可在每行创建一条导入语句。
使用带“*”导入的包	在此区域中，配置始终完全导入的包和类的列表。选项：静态：如果要声明所选类的静态导入，请选择此复选框。包：在此列的文本字段中，指定始终完全导入的包和类。请注意，输入完成后，IntelliJ IDEA 会自动添加到`.*`包名称的末尾。使用子包：选中此复选框可完全导入所选包的所有子包。添加包：单击此按钮可将新条目添加到包和类列表中。添加空白：单击此按钮可将空分隔符添加到包和类列表中。删除：单击此按钮可从列表中删除选定的包或类。
导入布局	在此区域中，配置导入语句在代码中的组织方式。您可以将某些类设置为第一个、最后一个或一个接着一个。导入的类将根据其包进行分组，并在包内按字母顺序排序。选项：单独布局静态导入：如果选中此复选框，则所有静态导入将保留在单独的部分中。否则，所有导入语句将根据指定的布局规则进行排序。静态：如果要声明所选包的静态导入，请选择此复选框。包：在此列的文本字段中，指定要导入的包。 With Subpackages：选择此复选框以使 IntelliJ IDEA 将布局规则应用到所选包的所有子包。添加包：单击此按钮可将新条目添加到包列表中。添加空白：单击此按钮可在所选条目后插入一个空行，这表示在相应的导入语句之间应插入一个空行。上移/下移：单击这些按钮可在列表中上移或下移包或空行，从而定义导入语句的顺序。删除：单击此按钮可从列表中删除选定的包。

代码生成

物品	描述
命名	喜欢较长的名称：突出显示查找列表中最长的名称以完成代码。如果禁用，请突出显示最短的名称。名称前缀和名称后缀：指定前缀和后缀，以生成使用 IntelliJ IDEA 代码生成功能命名新符号的建议。对于空白字段，使用不带前缀或后缀的默认名称建议。添加前缀值时，IntelliJ IDEA 会自动将建议的基本名称的第一个字母转换为大写。例如，如果静态字段的前缀定义为`s`且字段类型为`Counter`，则建议的静态字段名称将为`sCounter`。笔记该前缀不会影响 getter 和 setter 方法名称的生成。因此，在这种情况下，访问器名称将为`getCounter`和`setCounter`。
默认可见性	选择生成的字段和方法的默认访问级别。您可以明确指定它，也可以选择“升级”以自动将其提升到必要的级别。
变量声明	指定是否要`final`默认使用修饰符生成局部变量和参数。
评论代码	使用此区域配置生成注释的代码样式（行和块）：`Ctrl0/CtrlShift0/` 第一列行注释：在第一列开始行注释 ( )。如果禁用该选项，注释将与您的代码保持一致。`Ctrl0/` 在注释开始处添加空格：在行注释字符和注释行的第一个字符之间插入一个空格。强制重新格式化：重新格式化代码时，在现有注释中的行注释字符和注释行的第一个字符之间插入一个空格。请注意，第一个字符必须是字母数字符号，否则不会插入空格。例如，`//&Lorem ipsum`注释将被重新格式化程序忽略。当启用在评论开始处添加空格时，此选项可用。第一列块注释：在第一列开始块注释 ( )。如果禁用该选项，注释将与您的代码保持一致。`CtrlShift0/` 在块注释周围添加空格：在块注释字符和注释文本的第一个字符之间插入空格。
覆盖方法签名	插入@Override注解：`@Override`重写方法时插入注解。重复同步修饰符：`synchronized`当您重写同步方法时添加关键字。要复制的注释：指定应将哪些注释复制到您覆盖的方法。使用外部注释：提示您指定是否要将注释存储在源代码中还是外部。如果禁用，注释将默认添加到源代码中。
拉姆达身体	如果 lambda 表达式调用现有方法，最好使用方法引用按名称引用该方法。这些影响 Lambda 的复选框可以用方法参考检查来替换。如果启用，相应的 lambda 表达式将突出显示为警告并提供相关的快速修复。如果禁用，代码将不会突出显示，但用方法引用替换 lambda 表达式的意图仍然可用。尽可能使用 Class::isInstance 和 Class::cast 例如，替换`obj1 -> obj1 instanceof Foo`为`Foo.class::isInstance`和`obj -> (Foo)obj`。`Foo.class::cast` 将空检查替换为 Objects::nonNull 或 Objects::isNull 例如，替换`x -> x != null`为`Objects::nonNull`. 尽可能使用 Integer::sum 等例如，替换`(a, b) -> a + b`为`Integer::sum`.

感谢您的反馈意见！

此页面是否有帮助？