idea Java代码格式化规范

文章目录

引入

最近在公司开发中,遇到了一点小问题,组内各同事的格式化规范不一致。一来导致代码样式并不统一,二来有时候合并代码会出现冲突,因此做一套统一代码格式化规范很有必要。

基础知识

在idea中,可以通过快捷键Ctrl+Alt+L来格式化代码,如果没有做任何配置,idea本身也有一套默认的格式化标准。

除此以外,使用快捷键 Ctrl+Shift+Alt+L可以打开一个简易的格式化配置界面如下。

其他选项的说明,可以去官网查询,不同版本的idea有细微区别。Reformat File dialog

代码模板

如果所有开发者都使用Only VCS changed text,似乎就不存在互相影响,但仍然有两个问题。

  1. 整个工程的格式依然不统一;
  2. 不同开发者修改同一函数时,仍可能出发互相影响。

因此,我们还是需要找&写一个统一的格式化模板来处理。

idea模板

进入菜单settings -> Editor -> Code Style -> Java便可以对格式化代码的配置进行修改,idea还贴心的做了预览功能,可以很直观的看到变更。

同时,也支持导入导出配置。我配置好后,便可以分享给同事进行处理。

但单独基于这里去配置,其实比较复杂,需要逐项比对,建议还是导入导出来处理。不过网络上的大多数配置文件,仍是基于eclipse配置方式的xml。

eclipse模板

这里可以引入eclipse的xml模板。但实测此处引入,似乎并没有生效。因此,目前主流的方式还是需要安装插件。

1.安装插件

去市场搜索并安装Adapter For Eclipse Code Formatter的插件。

2.生成配置文件

当然是去找现成的配置文件啦。参考idea java EclipseFormatter代码格式化模板可以搞到阿里和唯品会的模板。

若我们对模板都不是很满意,也是可以自己调整配置的。我们简单看下配置文件的形式。

xml 复制代码
<!--略-->
<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_parameters" value="do not insert"/>
<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_invocation_arguments" value="do not insert"/>
<setting id="org.eclipse.jdt.core.formatter.insert_space_before_comma_in_allocation_expression" value="do not insert"/>
<!--略-->

对于这样的配置项,我们需要一个配置说明才能读懂(见附录一)。

3.导入配置文件

重启idea后,进入菜单。

如此,我们再使用快捷键Ctrl+Alt+L就可以使用上我们的自定义配置啦。

附录一:xml配置项说明

eclipse使用1.2代码自动格式化配置,这个资料很难找,目测不全,但暂时找不到更完整的了)。

insert_space_after_comma_in_annotation(insert/do_not_insert):在注释中的逗号后面插入空格,默认为insert;

insert_space_before_comma_in_type_parameters(insert/do_not_insert):用于在类型参数中在逗号前插入空格,默认为do_not_insert;

insert_space_before_opening_brace_in_type_declaration(insert/do_not_insert):用于在类型声明中打开括号之前插入空格,默认为insert;

insert_space_after_comma_in_type_arguments(insert/do_not_insert):用于在类型参数的逗号后面插入空格,默认为insert;

brace_position_for_anonymous_type_declaration(END_OF_LINE, NEXT_LINE, next_line_shift, NEXT_LINE_ON_WRAP):用于定位匿名类型声明的大括号,默认值:END_OF_LINE;

insert_space_before_colon_in_case(insert/do_not_insert):在冒号之前插入一个空格,在case语句中,默认为insert;

insert_space_after_opening_brace_in_array_initializer(insert/do_not_insert):用于在数组初始化器的开始括号之后插入空格,默认为do_not_insert;insert_new_line_in_empty_annotation_declaration(insert/do_not_insert):在空注释声明,默认为insert;insert_new_line_before_closing_brace_in_array_initializer(insert/do_not_insert):在数组初始化器的关闭括号之前插入新行,默认值:DO_NOT_INSERT;

insert_space_after_opening_paren_in_annotation(insert/do_not_insert):在注释中打开括号后插入空格,默认值:DO_NOT_INSERT;

blank_lines_before_field(其中n为零或正整数):用于在字段声明之前添加空行,默认为:0;insert_space_after_opening_paren_in_while(insert/do_not_insert):在一个while语句后面插入一个空格,默认值:DO_NOT_INSERT;insert_space_between_empty_parens_in_annotation_type_member_declaration(insert/do_not_insert):用于在注释类型成员声明中的空括号之间插入空格,默认值:DO_NOT_INSERT;

insert_new_line_before_else_in_if_statement(insert/do_not_insert):用于在if语句中的else关键字之前插入新行,默认值:DO_NOT_INSERT;

insert_space_after_prefix_operator(insert/do_not_insert):在前缀运算符之后插入空格的格式化,默认值:DO_NOT_INSERT;

keep_else_statement_on_same_line(TRUE, FALSE):以在同一行上保留else语句,默认为false;

insert_space_after_ellipsis(insert/do_not_insert):在省略之后插入一个空格,默认为insert;

comment.insert_new_line_for_parameter(insert/do_not_insert):在Javadoc根标记参数之后插入新行,默认为insert;

insert_space_before_opening_brace_in_annotation_type_declaration(insert/do_not_insert):在注释类型声明的开始括号之前插入空格,默认为insert;

indent_breaks_compare_to_cases(TRUE, FALSE):与cases相比,可以选择缩进中断,默认为true;

insert_space_after_at_in_annotation(insert/do_not_insert):在注释后面插入空格,默认为insert;

alignment_for_multiple_fields:用于对多个字段进行对齐,可能的值:由createAlignmentValue(boolean, int, int)调用返回的值------默认值:createAlignmentValue(false, WRAP_COMPACT, INDENT_DEFAULT);

alignment_for_expressions_in_array_initializer:用于数组初始化器中表达式对齐的格式化,可能的值:由createAlignmentValue(boolean, int, int)调用返回的值,默认:createAlignmentValue(false, WRAP_COMPACT, INDENT_DEFAULT)

alignment_for_conditional_expression:条件表达式对齐的格式化;insert_space_before_opening_paren_in_for(insert/do_not_insert):用于在for语句的圆括号前插入一个空格,默认为insert;

insert_space_after_binary_operator(insert/do_not_insert):在二进制操作符之后插入空格,默认为insert;

insert_space_before_question_in_wildcard(insert/do_not_insert):在通配符中问号前插入空格,默认值:DO_NOT_INSERT;

brace_position_for_array_initializer(END_OF_LINE, NEXT_LINE, next_line_shift, NEXT_LINE_ON_WRAP):用于定位数组初始化程序的大括号,默认值:END_OF_LINE;

insert_space_between_empty_parens_in_enum_constant(insert/do_not_insert):用于在enum常量的空括号之间插入空格,默认值:DO_NOT_INSERT;

insert_new_line_before_finally_in_try_statement(insert/do_not_insert):用于在try语句中的finally关键字之前插入新行,默认值:DO_NOT_INSERT;insert_new_line_after_annotation_on_local_variable(insert/do_not_insert):在本地变量注释后插入新行,默认:INSERT;

insert_new_line_before_catch_in_try_statement(insert/do_not_insert):在try语句,在catch关键字之前插入新行,默认值:DO_NOT_INSERT;

insert_space_before_opening_paren_in_while(insert/do_not_insert):用于在while语句中打开括号之前插入空格,默认为insert;

blank_lines_after_package(其中n为0或为正整数):用于在包声明之后添加空行,默认值:"0";

insert_space_after_comma_in_type_parameters(insert/do_not_insert):在类型参数中,在逗号之后插入空格,默认为insert;

continuation_indentation(其中n为零或正整数):设置延续缩进,默认值:"2";

insert_space_after_postfix_operator(insert/do_not_insert):在后缀操作符之后插入空格的,默认值:DO_NOT_INSERT;

alignment_for_arguments_in_method_invocation:用于方法调用中参数对齐的;

insert_space_before_closing_angle_bracket_in_type_arguments(insert/do_not_insert):在类型参数的关闭角括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_comma_in_superinterfaces(insert/do_not_insert):在类型头中的超接口名称中插入逗号前的空格,默认值:DO_NOT_INSERT;

blank_lines_before_new_chunk(其中n为零或正整数):用于在新块之前添加空行,默认值:"0;

blank_lines_before_package(其中n为零或正整数):在包声明之前添加空行,默认值:"0;

insert_space_after_comma_in_enum_constant_arguments(insert/do_not_insert):用于在enum常量,在逗号之后插入空格,默认为insert;

insert_space_after_opening_paren_in_constructor_declaration(insert/do_not_insert):构造函数声明中插入空格,默认:DO_NOT_INSERT;

insert_space_after_closing_angle_bracket_in_type_arguments(insert/do_not_insert):在类型参数的结束角括号之后插入空格,默认为insert;

comment.format_line_comments(TRUE, FALSE):控制单行注释是否格式化,默认为TRUE;

insert_space_after_comma_in_enum_declarations(insert/do_not_insert):在enum声明中,在逗号后插入空格,默认值:INSERT;

insert_space_before_opening_brace_in_block(insert/do_not_insert):用于在块中打开括号之前插入空格,默认值:INSERT;

alignment_for_arguments_in_explicit_constructor_call:用于显式构造函数调用中的参数对齐;

insert_space_before_comma_in_method_invocation_arguments(insert/do_not_insert):在方法调用的参数中,在逗号之前插入空格,默认:DO_NOT_INSERT;

blank_lines_before_member_type(其中n为零或正整数):用于在成员类型声明之前添加空行,默认值:"0;

align_type_members_on_columns(TRUE, FALSE):在列上对齐类型声明的类型成员,默认为false;

insert_space_after_opening_paren_in_enum_constant(insert/do_not_insert):在enum常量中打开括号之后插入空格,默认值:DO_NOT_INSERT;

insert_space_after_opening_paren_in_for(insert/do_not_insert):在for语句中插入空格后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_brace_in_method_declaration(insert/do_not_insert):用于在方法声明中的打开括号之前插入空格,默认值:INSERT;

alignment_for_selector_in_method_invocation:方法调用中选择器对齐;

insert_space_after_opening_paren_in_switch(insert/do_not_insert):用于在switch语句中打开括号后插入空格,默认值:DO_NOT_INSERT;

insert_space_after_unary_operator(insert/do_not_insert):在一个一元操作符后面插入空格,默认值:DO_NOT_INSERT;

insert_space_after_colon_in_case(insert/do_not_insert):用于在case语句中,当冒号后插入空格,默认值:INSERT;

indent_parameter_description(TRUE, FALSE):用于控制Javadoc参数的描述是否缩进,默认为TRUE;

insert_space_before_closing_paren_in_method_declaration(insert/do_not_insert):在方法声明中的结束括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_closing_paren_in_switch(insert/do_not_insert):在switch语句中关闭括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_brace_in_enum_declaration(insert/do_not_insert):在enum声明的开始括号之前插入空格,默认值:INSERT;

insert_space_before_opening_angle_bracket_in_type_parameters(insert/do_not_insert):在类型参数前插入空格,默认值:DO_NOT_INSERT;

insert_new_line_in_empty_type_declaration(insert/do_not_insert):在空类型声明中插入新行,默认值:INSERT;

comment.clear_blank_lines_in_block_comment(TRUE, FALSE):用于控制块注释中的空行是否被清除,默认为FLASE;

insert_space_before_opening_paren_in_if(insert/do_not_insert):用于在if语句中打开括号之前插入空格,默认值:INSERT;

insert_space_between_brackets_in_array_type_reference(insert/do_not_insert):用于在数组类型引用的括号中插入空格,默认值:DO_NOT_INSERT;

insert_space_after_opening_paren_in_parenthesized_expression(insert/do_not_insert):用于在圆括号中展开括号之后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_comma_in_explicitconstructorcall_arguments(insert/do_not_insert):在显式构造函数调用的参数中插入逗号前的空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_brace_in_constructor_declaration(insert/do_not_insert):在构造函数声明的开始括号之前插入空格,默认值:INSERT;

blank_lines_before_first_class_body_declaration(n为0或正整数):在第一个类body声明之前添加空行,-默认值:"0";

indentation.size(其中n为0或正整数):指定表示一个缩进的等效空格数,只有当选项卡char设置为混合时才使用此选项,默认值:"4";

insert_space_between_empty_parens_in_method_declaration(insert/do_not_insert):用于在方法声明中的空括号之间插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_paren_in_enum_constant(insert/do_not_insert):在enum常量中打开括号之前插入空格,默认值:DO_NOT_INSERT;

alignment_for_superclass_in_type_declaration:用于在类型声明中对超类进行对齐;

alignment_for_assignment:分配对齐;

tabulation.char(TAB,空格,混合):指定表格大小,默认为TAB;

insert_space_after_comma_in_constructor_declaration_parameters(insert/do_not_insert):用于在构造函数声明的参数中插入逗号后的空格,默认值:INSERT;

insert_space_before_prefix_operator(insert/do_not_insert):用于在前缀操作符之前插入空格,默认值:DO_NOT_INSERT;

indent_statements_compare_to_body(TRUE, FALSE):在方法或构造函数的主体内缩进语句的,默认为TRUE;

blank_lines_before_method(其中n为零或正整数):用于在方法声明之前添加空行,默认值:"0"

format_guardian_clause_on_one_line(TRUE, FALSE):在一个行中保留保护条款,默认为FLASE;

insert_space_before_colon_in_for(insert/do_not_insert):用于在for语句的冒号之前插入空格,默认值:INSERT;

insert_space_before_closing_paren_in_cast(insert/do_not_insert):在转换表达式中关闭括号之前插入空格,默认值:DO_NOT_INSERT;

alignment_for_parameters_in_constructor_declaration:构造函数声明中参数对齐;

insert_space_after_colon_in_labeled_statement(insert/do_not_insert):在冒号后插入一个标记语句中的空格,默认值:INSERT;

brace_position_for_annotation_type_declaration(END_OF_LINE, NEXT_LINE, next_line_moved, NEXT_LINE_ON_WRAP):用于定位注释类型声明的大括号,默认值:END_OF_LINE;

insert_space_before_closing_paren_in_method_invocation(insert/do_not_insert):在方法调用的结束括号之前插入一个空格,默认值:DO_NOT_INSERT;

insert_new_line_in_empty_method_body(insert/do_not_insert):在空方法体中插入新行,默认值:INSERT;

insert_space_after_opening_bracket_in_array_allocation_expression(insert/do_not_insert):在数组分配表达式的左括号后面插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_brace_in_enum_constant(insert/do_not_insert):在enum中,在开环前插入一个空格,默认值:INSERT;

insert_space_before_comma_in_annotation(insert/do_not_insert):用于在注释中逗号前插入空格,默认值:DO_NOT_INSERT;

insert_space_after_at_in_annotation_type_declaration(insert/do_not_insert):用于在注释类型声明之后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_comma_in_method_declaration_throws(insert/do_not_insert):在方法声明的throw子句的异常名称中,在逗号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_closing_paren_in_if(insert/do_not_insert):在if语句的结束括号之前插入空格,默认值:DO_NOT_INSERT;

brace_position_for_switch(END_OF_LINE, NEXT_LINE, next_line_shift, NEXT_LINE_ON_WRAP):定位switch语句的大括号,默认为END_OF_LINE;

insert_space_after_comma_in_method_declaration_throws(insert/do_not_insert):在方法声明的抛出子句的异常名称中,在逗号之后插入空格,默认值:INSERT;

insert_space_before_parenthesized_expression_in_return(insert/do_not_insert):在返回语句中的括号表达式之前插入空格,默认值:INSERT;

insert_space_before_opening_paren_in_annotation(insert/do_not_insert):用于在注释中打开括号之前插入空格,默认值:INSERT;

insert_space_after_question_in_conditional(insert/do_not_insert):在条件表达式的问号后面插入空格,默认值:DO_NOT_INSERT;

insert_space_after_question_in_wildcard(insert/do_not_insert):在通配符中问号后面插入空格,默认值:DO_NOT_INSERT;

insert_space_before_closing_bracket_in_array_allocation_expression(insert/do_not_insert):在数组分配表达式中插入一个空格,默认值:DO_NOT_INSERT;

insert_space_before_parenthesized_expression_in_throw(insert/do_not_insert):在抛出语句中插入括号表达式之前的空格,默认值:INSERT;

insert_space_before_comma_in_type_arguments(insert/do_not_insert):用于在类型参数中在逗号之前插入空格,默认值:DO_NOT_INSERT;

indent_switchstatements_compare_to_switch(TRUE, FALSE):以缩进switch语句比较切换,默认为TRUE;

insert_space_before_ellipsis(insert/do_not_insert):在省略号之前插入空格,默认值:DO_NOT_INSERT;

brace_position_for_block(END_OF_LINE, NEXT_LINE, NEXT_LINE_SHIFTED, NEXT_LINE_ON_WRAP):定位块的括号,默认为END_OF_LINE;

insert_space_before_comma_in_for_inits(insert/do_not_insert):用于在for语句的初始化中,在逗号之前插入空格,默认值:DO_NOT_INSERT;

brace_position_for_method_declaration( END_OF_LINE, NEXT_LINE, NEXT_LINE_SHIFTED, NEXT_LINE_ON_WRAP):用于定位方法声明的大括号,默认为END_OF_LINE;

compact_else_if(TRUE, FALSE):压缩else/if,默认为TRUE;

insert_space_before_comma_in_array_initializer(insert/do_not_insert):在逗号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_after_comma_in_for_increments(insert/do_not_insert):在for语句的增量中,在逗号后面插入空格,默认值:INSERT;

insert_space_before_closing_bracket_in_array_reference(insert/do_not_insert):用于在数组引用的结束括号前插入空格,默认值:DO_NOT_INSERT;

brace_position_for_enum_constant(END_OF_LINE, NEXT_LINE, next_line_shift, NEXT_LINE_ON_WRAP):用于定位枚举常量的括号,默认为END_OF_LINE;

comment.indent_root_tags(TRUE, FALSE):控制Javadoc根标签是否缩进,默认为TRUE;

insert_space_before_comma_in_enum_declarations(insert/do_not_insert):在枚举声明中插入逗号前的空格,默认值:DO_NOT_INSERT;

insert_space_after_comma_in_explicitconstructorcall_arguments(insert/do_not_insert):用于在显式构造函数调用的参数中,在逗号之后插入空格,默认值:INSERT;

insert_space_before_opening_brace_in_switch(insert/do_not_insert):用于在开关语句的开始括号前插入空格,默认值:INSERT;

insert_space_after_comma_in_superinterfaces(insert/do_not_insert):在类型头的超接口名称中,在逗号之后插入空格,默认值:INSERT;

insert_space_before_comma_in_method_declaration_parameters(insert/do_not_insert):在方法声明的参数中,在逗号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_comma_in_allocation_expression(insert/do_not_insert):在分配表达式中插入一个空格,默认值:DO_NOT_INSERT;

tabulation.size(其中n为0或为正整数):指定表示一个表格的等效空格数,默认值:"4;

insert_space_before_opening_bracket_in_array_type_reference(insert/do_not_insert):用于在数组类型引用的左括号前插入空格,默认值:DO_NOT_INSERT;

insert_new_line_after_opening_brace_in_array_initializer(insert/do_not_insert):用于在数组初始化器的开始括号之后插入新行,默认值:DO_NOT_INSERT;

insert_space_after_closing_brace_in_block(insert/do_not_insert):在块的闭括号之后插入空格,默认值:INSERT;

insert_space_before_opening_bracket_in_array_reference(insert/do_not_insert):在数组引用的左括号之前插入空格,默认值:DO_NOT_INSERT;

insert_new_line_in_empty_enum_constant(insert/do_not_insert):在空enum常量中插入新行,默认值:INSERT;

insert_space_after_opening_angle_bracket_in_type_arguments(insert/do_not_insert):用于在类型参数的开始角括号之后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_paren_in_constructor_declaration(insert/do_not_insert):用于在构造函数声明中打开括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_after_opening_paren_in_if(insert/do_not_insert):在if语句中打开括号后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_comma_in_constructor_declaration_throws(insert/do_not_insert):在构造函数声明的throw子句的异常名称中,在逗号之前插入空格,默认值:DO_NOT_INSERT;

comment.clear_blank_lines_in_javadoc_comment(TRUE, FALSE):用于控制在javadoc注释中是否清除空行,默认为FALSE;

alignment_for_throws_clause_in_constructor_declaration:用于在构造函数声明中对齐抛出子句;

insert_space_after_assignment_operator(insert/do_not_insert):在赋值操作符之后插入空格,默认值:INSERT;

insert_space_before_assignment_operator(insert/do_not_insert):在赋值运算符之前插入空格,默认值:INSERT;

indent_empty_lines(TRUE, FALSE):缩进空行,默认为false;

insert_space_after_opening_paren_in_synchronized(insert/do_not_insert):在同步语句中打开括号后插入空格,默认值:DO_NOT_INSERT;

insert_space_after_closing_paren_in_cast(insert/do_not_insert):在转换表达式的结束括号之后插入空格,默认值:INSERT;

insert_space_after_comma_in_method_declaration_parameters(insert/do_not_insert):在方法声明的参数中插入逗号之后的空格,默认值:INSERT;

brace_position_for_block_in_case(END_OF_LINE、NEXT_LINE、next_line_shift、NEXT_LINE_ON_WRAP):当块是后面的第一个语句时,将块的大括号放在case语句中,默认值:END_OF_LINE;

number_of_empty_lines_to_preserve(其中n为0或正整数):指定要保存的空行数,默认值:"0";

insert_space_before_opening_paren_in_method_declaration(insert/do_not_insert):在方法声明中打开括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_after_opening_paren_in_catch(insert/do_not_insert):在catch中开括号后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_closing_paren_in_constructor_declaration(insert/do_not_insert):用于在构造函数声明中关闭括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_paren_in_method_invocation(insert/do_not_insert):在方法调用中打开括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_after_opening_bracket_in_array_reference(insert/do_not_insert):在数组引用的左括号后面插入空格,默认值:DO_NOT_INSERT;

insert_space_after_and_in_type_parameter(insert/do_not_insert):用于在wilcard后和中插入空格,默认值:INSERT;

alignment_for_arguments_in_qualified_allocation_expression:用于在限定分配表达式中对齐参数;

continuation_indentation_for_array_initializer(其中n为0或为正整数):用于设置数组初始化器中的延续缩进,默认值:"2";

insert_space_between_empty_brackets_in_array_allocation_expression(insert/do_not_insert):在数组分配表达式的空括号之间插入空格,默认值:DO_NOT_INSERT;

insert_space_before_at_in_annotation_type_declaration(insert/do_not_insert):在注释类型声明之前插入空格,默认值:INSERT;

alignment_for_arguments_in_allocation_expression:用于在分配表达式中对齐参数;

insert_space_after_opening_paren_in_cast(insert/do_not_insert):在转换表达式中打开括号后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_unary_operator(insert/do_not_insert):在一元运算符之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_closing_angle_bracket_in_parameterized_type_reference(insert/do_not_insert):在参数化类型引用的结束角括号前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_brace_in_anonymous_type_declaration(insert/do_not_insert):用于在匿名类型声明中打开括号前插入空格,默认值:INSERT;

keep_empty_array_initializer_on_one_line(TRUE, FALSE):要保持空数组初始化器一行,默认值:FALSE;

insert_new_line_in_empty_enum_declaration(insert/do_not_insert):在空枚举声明中插入新行,默认值:INSERT;

keep_imple_if_on_one_line(TRUE, FALSE):用于在一行中保持简单的if语句,默认为FLASE;

insert_space_before_comma_in_constructor_declaration_parameters(insert/do_not_insert):用于在构造函数声明的参数中插入逗号前的空格,默认值:DO_NOT_INSERT;

insert_space_after_closing_angle_bracket_in_type_parameters(insert/do_not_insert):在类型参数的结束角括号之后插入空格,默认值:INSERT;

insert_new_line_at_end_of_file_if_missing(insert/do_not_insert):如果缺少的话,可以在当前文件的末尾插入新行,默认值:DO_NOT_INSERT;

insert_space_after_colon_in_for(insert/do_not_insert):在for语句中,在冒号后插入空格,默认值:INSERT;

insert_space_before_colon_in_labeled_statement(insert/do_not_insert):在冒号之前插入一个标记语句的空格,默认值:INSERT;

insert_space_before_comma_in_parameterized_type_reference(insert/do_not_insert):在参数化类型引用中在逗号之前插入空格,默认值:DO_NOT_INSERT;

alignment_for_superinterfaces_in_type_declaration:用于在类型声明中对超接口进行对齐;

alignment_for_binary_expression:用于二进制表达式的对齐brace_position_for_enum_declaration{END_OF_LINE, NEXT_LINE, next_line_shift, NEXT_LINE_ON_WRAP} :用于定位enum声明的大括号.默认值:END_OF_LINE;

insert_space_before_closing_paren_in_while(insert/do_not_insert):用于在while语句中结束括号之前插入空格,默认值:DO_NOT_INSERT;

put_empty_statement_on_new_line({TRUE, FALSE):用于指定空语句是否应该位于一个新的行,默认:FALSE;

insert_new_line_after_annotation_on_parameter(insert/do_not_insert):在参数的注释之后插入新行,默认值:DO_NOT_INSERT;

insert_space_after_opening_angle_bracket_in_type_parameters(insert/do_not_insert):

在类型参数中,在开始角括号之后插入空格,默认值:DO_NOT_INSERT;

insert_space_between_empty_parens_in_method_invocation(insert/do_not_insert):在方法调用的空括号之间插入空格,默认值:DO_NOT_INSERT;

insert_new_line_before_while_in_do_statement(insert/do_not_insert):在do语句之前插入新行,默认值:DO_NOT_INSERT;

alignment_for_arguments_in_enum_constant:为了在enum常量中对齐参数。

comment.format_javadoc_comments(TRUE, FALSE):用于控制javadoc注释是否被格式化,默认为TRUE;

comment.line_length(其中n为0或为正整数):指定注释的行长度,默认值:"80";

blank_lines_between_import_groups(其中n为0或为正整数):添加导入组之间的空行,默认值:"1";

insert_space_before_comma_in_enum_constant_arguments(insert/do_not_insert):在enum常量的参数中,在逗号前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_semicolon(insert/do_not_insert):在分号前插入空格,默认值:DO_NOT_INSERT;

brace_position_for_constructor_declaration { END_OF_LINE, NEXT_LINE, NEXT_LINE_SHIFTED, NEXT_LINE_ON_WRAP }:用于定位构造函数声明的大括号,默认值:END_OF_LINE;

number_of_blank_lines_at_beginning_of_method_body(其中n为0或正整数):在方法主体的开头添加空行,默认值:"0";

insert_space_before_colon_in_conditional(insert/do_not_insert):用于在条件表达式的冒号前插入空格,默认值:INSERT;

indent_body_declarations_compare_to_type_header(TRUE, FALSE):将缩进体声明与它的封闭类型heade进行比较,默认为TRUE;

insert_space_before_opening_paren_in_annotation_type_member_declaration(insert/do_not_insert):在注释类型成员声明中打开括号之前插入空格,默认值:DO_NOT_INSERT;

wrap_before_binary_operator(TRUE, FALSE):在二进制运算符之前包装,默认为TRUE;

indent_body_declarations_compare_to_enum_declaration_header(TRUE, FALSE):与所附的enum声明头相比,缩进正文声明,默认为TRUE;

blank_lines_between_type_declarations(其中n为0或为正整数):在类型声明之间添加空白行,默认值:"0";

insert_space_before_closing_paren_in_synchronized(insert/do_not_insert):在同步语句的结束括号之前插入空格,默认值:DO_NOT_INSERT;

indent_statements_compare_to_block(TRUE, FALSE):在块内缩进语句,默认为TRUE;

alignment_for_superinterfaces_in_enum_declaration:用于枚举声明中的超接口对齐;

insert_space_before_question_in_conditional(insert/do_not_insert):在条件表达式的问号前插入空格,默认值:INSERT;

insert_space_before_comma_in_multiple_field_declarations(insert/do_not_insert):用于在多个字段声明中在逗号之前插入空格,默认值:DO_NOT_INSERT;

alignment_for_compact_if:对于紧凑型if的对齐;

insert_space_after_comma_in_for_inits(insert/do_not_insert):用于在for语句的初始化中,在逗号之后插入空格,默认值:INSERT;

indent_switchstatements_compare_to_cases(TRUE, FALSE):对缩进开关语句进行比较,默认为TRUE;

insert_space_after_comma_in_array_initializer(insert/do_not_insert):在数组初始化器中插入逗号之后的空格,默认值:INSERT;

insert_space_before_colon_in_default(insert/do_not_insert):用于在默认语句中冒号之前插入空格,默认值:INSERT;

insert_space_before_and_in_type_parameter(insert/do_not_insert):用于在通配符前面和里面插入空格,默认值:INSERT;

insert_space_between_empty_parens_in_constructor_declaration(insert/do_not_insert):在构造函数声明的空括号之间插入空格,默认值:DO_NOT_INSERT;

insert_space_after_colon_in_assert(insert/do_not_insert):用于在assert语句中冒号之后插入空格,默认值:INSERT;

blank_lines_before_imports(其中n为0或为正整数):在导入声明之前添加空行,默认值:"0";

comment.format_html(TRUE, FALSE):控制HTML标签是否被格式化,默认为TRUE;

alignment_for_throws_clause_in_method_declaratio:用于方法声明中抛出子句的对齐;

insert_space_before_closing_angle_bracket_in_type_parameters(insert/do_not_insert):用于在类型参数中的结束角括号前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_bracket_in_array_allocation_expression(insert/do_not_insert):用于在数组分配表达式的左括号前插入空格,默认值:DO_NOT_INSERT;

insert_new_line_in_empty_anonymous_type_declaration(insert/do_not_insert):在空的匿名类型声明中插入新行,默认值:INSERT;

insert_space_after_colon_in_conditional(insert/do_not_insert):在条件表达式的冒号后面插入空格,默认值:INSERT;

insert_space_after_opening_angle_bracket_in_parameterized_type_reference(insert/do_not_insert):在参数化类型引用的开始角括号之后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_closing_paren_in_for(insert/do_not_insert):在for语句的结束括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_postfix_operator(insert/do_not_insert):在后缀操作符之前插入空格,默认值:DO_NOT_INSERT;

comment.format_source_code(TRUE, FALSE):用于控制代码片段是否在注释中格式化,默认为TRUE;

insert_space_before_opening_paren_in_synchronized(insert/do_not_insert):在同步语句中打开括号之前插入空格,默认值:INSERT;

insert_space_after_comma_in_allocation_expression(insert/do_not_insert):在分配表达式的逗号后面插入空格,默认值:INSERT;

insert_space_after_comma_in_constructor_declaration_throws(insert/do_not_insert):用于在构造函数声明的throw子句的异常名称后面插入一个空格,默认值:INSERT;

alignment_for_parameters_in_method_declaration:方法声明中参数的对齐;

insert_space_before_closing_brace_in_array_initializer(insert/do_not_insert):用于在数组初始化器的闭括号前插入空格,默认值:DO_NOT_INSERT;

use_tabs_only_for_leading_indentations(TRUE, FALSE):用于对缩进和空格进行行包装,默认为FALSE;

insert_new_line_after_annotation_on_member(insert/do_not_insert):在成员的注释(包、类、方法、字段声明)之后插入新行,默认值:INSERT;

comment.format_header(TRUE, FALSE):控制Java源文件的头注释是否被格式化,默认为FALSE;

comment.format_block_comments(TRUE, FALSE):用于控制多行注释是否被格式化,默认为TRUE;

insert_space_before_closing_paren_in_enum_constant(insert/do_not_insert):在enum常量中关闭括号之前插入空格,默认值:DO_NOT_INSERT;

alignment_for_enum_constants:对于枚举常数的对齐;

insert_new_line_in_empty_block(insert/do_not_insert):用于在空块中插入新行,默认值:INSERT;

indent_body_declarations_compare_to_annotation_declaration_header(TRUE, FALSE):将缩进主体声明与其所包含的注释声明头进行比较,默认为TRUE;

insert_space_before_closing_paren_in_parenthesized_expression(insert/do_not_insert):在圆括号中的圆括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_paren_in_parenthesized_expression(insert/do_not_insert):在括号内的括号前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_closing_paren_in_catch(insert/do_not_insert):用于在catch - Option id中关闭括号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_comma_in_multiple_local_declarations(insert/do_not_insert):用于在多个本地声明中在逗号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_before_opening_paren_in_switch(insert/do_not_insert):用于在switch语句中打开括号之前插入空格,默认值:INSERT;

insert_space_before_comma_in_for_increments(insert/do_not_insert):用于在for语句的增量中在逗号之前插入空格,默认值:DO_NOT_INSERT;

insert_space_after_opening_paren_in_method_invocation(insert/do_not_insert):在方法调用中打开括号后插入空格,默认值:DO_NOT_INSERT;

insert_space_before_colon_in_assert(insert/do_not_insert):在assert语句中在冒号之前插入空格,默认值:INSERT;

brace_position_for_type_declaration{ END_OF_LINE, NEXT_LINE, NEXT_LINE_SHIFTED, NEXT_LINE_ON_WRAP }:用于定位类型声明的大括号,默认值:END_OF_LINE

insert_space_before_opening_brace_in_array_initializer(insert/do_not_insert):在数组初始化器中插入一个空格前插入一个空格,默认值:DO_NOT_INSERT;

insert_space_between_empty_braces_in_array_initializer(insert/do_not_insert):在数组初始化器中插入空括号之间的空格,默认值:DO_NOT_INSERT;

insert_space_after_opening_paren_in_method_declaration(insert/do_not_insert):用于在方法声明中打开括号后插入空格,默认:DO_NOT_INSERT;

insert_space_before_semicolon_in_for(insert/do_not_insert):在for语句中分号前插入空格,默认:DO_NOT_INSERT;

insert_space_before_opening_paren_in_catch(insert/do_not_insert):在catch中打开括号之前插入空格,默认值:INSERT;

insert_space_before_opening_angle_bracket_in_parameterized_type_reference(insert/do_not_insert):用于在参数化类型引用的开始角括号前插入空格,默认:DO_NOT_INSERT;

insert_space_after_comma_in_multiple_field_declarations(insert/do_not_insert):在多个字段声明中,在逗号后插入空格,默认值:INSERT;

insert_space_before_closing_paren_in_annotation(insert/do_not_insert):在注释中的结束括号之前插入空格,默认:DO_NOT_INSERT;

insert_space_after_comma_in_parameterized_type_reference(insert/do_not_insert):在参数化类型引用中,在逗号之后插入空格,默认值:INSERT;

insert_space_after_comma_in_method_invocation_arguments(insert/do_not_insert):在方法调用的参数中,在逗号之后插入空格,默认值:INSERT;

blank_lines_after_imports(其中n为0或为正整数):在导入声明之后添加空行,默认值:"0";

insert_space_after_comma_in_multiple_local_declarations(insert/do_not_insert):在多个本地声明中插入逗号之后的空格,默认值:INSERT;

indent_body_declarations_compare_to_enum_constant_header(TRUE, FALSE):对于缩进体声明,与它的封闭枚举常量标题比较,默认为TRUE;

insert_space_after_semicolon_in_for(insert/do_not_insert):用于在for语句中在分号之后插入空格,默认值:INSERT;

never_indent_line_comments_on_first_column(TRUE, FALSE):缩进从第一列开始的行注释,默认为FALSE;

insert_space_before_opening_angle_bracket_in_type_arguments(insert/do_not_insert):用于在类型参数的开始角括号前插入空格,默认:DO_NOT_INSERT;

never_indent_block_comments_on_first_column(TRUE, FALSE):对从第一列开始的注释进行缩进,默认为FALSE;

keep_then_statement_on_same_line(TRUE, FALSE):将语句保持在同一直线上,默认为FALSE;

附录二:赠送

赠送几个我在实操中调整了的配置:

  • enum不强制换行。
xml 复制代码
<setting id="org.eclipse.jdt.core.formatter.alignment_for_enum_constants" value="49"/>
<!--参考文档:https://www.5axxw.com/questions/content/pl3la3-->
  • 需要调整缩进,由tab转为空格。
xml 复制代码
<setting id="org.eclipse.jdt.core.formatter.tabulation.char" value="space"/>
  • 自动换行的长度与公司规定不一致。
xml 复制代码
<setting id="org.eclipse.jdt.core.formatter.lineSplit" value="150"/>
相关推荐
Theodore_10223 小时前
4 设计模式原则之接口隔离原则
java·开发语言·设计模式·java-ee·接口隔离原则·javaee
冰帝海岸4 小时前
01-spring security认证笔记
java·笔记·spring
世间万物皆对象4 小时前
Spring Boot核心概念:日志管理
java·spring boot·单元测试
没书读了5 小时前
ssm框架-spring-spring声明式事务
java·数据库·spring
小二·5 小时前
java基础面试题笔记(基础篇)
java·笔记·python
开心工作室_kaic5 小时前
ssm161基于web的资源共享平台的共享与开发+jsp(论文+源码)_kaic
java·开发语言·前端
懒洋洋大魔王5 小时前
RocketMQ的使⽤
java·rocketmq·java-rocketmq
武子康5 小时前
Java-06 深入浅出 MyBatis - 一对一模型 SqlMapConfig 与 Mapper 详细讲解测试
java·开发语言·数据仓库·sql·mybatis·springboot·springcloud
转世成为计算机大神6 小时前
易考八股文之Java中的设计模式?
java·开发语言·设计模式
小江村儿的文杰6 小时前
XCode Build时遇到 .entitlements could not be opened 的问题
ide·macos·ue4·xcode