idea配置阿里格式化模板+注释模板

1 背景

本文意在将idea中的代码格式和注释格式进行统一化。

研发团队的成员的代码格式和注释格式建议统一化。

统一的代码格式和注释格式，能给代码阅读上带来极大的便利，给代码改动上提高极大的效率。

1.1 开发工具

idea

1.2 代码格式化模板

阿里格式化模板

1.3 注释模板

（1）类模板样例

/**
 * （自定义类描述）
 * @author zhangsan
 * @date 2020/09/08 08:23
 **/
public class MyTest {
   
   
}

（2）方法模板样例

/**
 * （自定义方法描述）
 * @author zhangsan
 * @date 2020/09/07 20:07
 * @param message 
 * @param name 
 * @return java.lang.String 
 */
public String myTest(String message,String name){
   
   
	return "";
}

无参方法，将不生成@param参数：

/**
 * （自定义方法描述）
 * @author zhangsan
 * @date 2020/09/08 08:02
 * @return java.lang.String 
 */
public String myTest(){
   
   
	return "";
}

2 下载模板文件

阿里模板下载地址

https://github.com/alibaba/p3c/tree/master/p3c-formatter

下载如下两个模板文件（链接为下载页面）：

代码格式（用于代码格式化）：eclipse-codestyle.xml

代码模板（代码注释模板，IDEA中无法使用）：eclipse-codetemplate.xml

3 IDEA代码格式化

因阿里提供的代码格式化配置是基于eclipse的，如需在idea中使用此配置，需要安装对应的eclipse插件</