IDEA 给Java代码设置规范 idea怎么规范代码格式

转载

mob6454cc72ae38 2023-11-07 00:32:22

文章标签 IDEA 给Java代码设置规范 intellij-idea java intellij idea 注释模板 文章分类 Java 后端开发

背景

本文意在将IDEA中的代码格式和注释格式进行统一化。
研发团队的成员的代码格式和注释格式统一化。
统一的代码格式和注释格式，能给代码阅读上带来极大的便利，给代码改动上提高极大的效率。

代码格式话模板配置（非必要配置，也可直接使用IDEA默认格式化即可）

下载阿里配置文件（eclipse-codestyle.xml），因为此文件是针对ecplice的，在IDEA中使用配置文件，需要安装Eclipse Code Formatter插件
配置代码格式，File->Settings->Other Settings->Eclipse Code Formatter进行idea代码格式配置：将代码格式化文件eclipse-codestyle.xml，配置到插件中：

IDEA代码注释模板配置

为了减少警告以及更好的集成统一API的文档第三方工具，我们严格按照java文档注释来配置相关的模板配置。

类注释模板配置

IDEA配置导航地址：settings->Editor->File and Code Templates->Files->class

IDEA 给Java代码设置规范 idea怎么规范代码格式_java

类注释模板（注释模板的上的空行也算是模板的一部分不要更改，复制到指定位置并且一定保持与给出的模板一模一样，换行以及*以及*号之间的空格都要一一对应）

/**
 * ${NAME} ${description} 
 * @author ${USER} 
 * @version ${YEAR}/${MONTH}/${DAY} ${HOUR}:${MINUTE}
**/
public class ${NAME} {
}

接口注释模板配置

IDEA配置导航地址：settings->Editor->File and Code Templates->Files->Interface

IDEA 给Java代码设置规范 idea怎么规范代码格式_intellij-idea_02

接口注释模板（注释模板的上的空行也算是模板的一部分不要更改，复制到指定位置并且一定保持与给出的模板一模一样，换行以及*以及*号之间的空格都要一一对应）

/**
 * ${NAME} ${description} 
 * @author ${USER} 
 * @version ${YEAR}/${MONTH}/${DAY} ${HOUR}:${MINUTE}
**/
public interface ${NAME} {
}

枚举注释模板配置

IDEA配置导航地址：settings->Editor->File and Code Templates->Files->Enum

IDEA 给Java代码设置规范 idea怎么规范代码格式_IDEA 给Java代码设置规范_03

枚举注释模板（注释模板的上的空行也算是模板的一部分不要更改，复制到指定位置并且一定保持与给出的模板一模一样，换行以及*以及*号之间的空格都要一一对应）

/**
 * ${NAME} ${description} 
 * @author ${USER} 
 * @version ${YEAR}/${MONTH}/${DAY} ${HOUR}:${MINUTE}
**/
public enum ${NAME} {
}

注解注释模板配置

IDEA 给Java代码设置规范 idea怎么规范代码格式_IDEA 给Java代码设置规范_04

注解注释模板（注释模板的上的空行也算是模板的一部分不要更改，复制到指定位置并且一定保持与给出的模板一模一样，换行以及*以及*号之间的空格都要一一对应）

/**
 * ${NAME} ${description} 
 * @author ${USER} 
 * @version ${YEAR}/${MONTH}/${DAY} ${HOUR}:${MINUTE}
**/
public @interface ${NAME} {
}

方法注释模板配置

IDEA配置导航地址：settings->Editor->Live Templates

IDEA 给Java代码设置规范 idea怎么规范代码格式_IDEA 给Java代码设置规范_05

IDEA 给Java代码设置规范 idea怎么规范代码格式_intellij idea_06

IDEA 给Java代码设置规范 idea怎么规范代码格式_注释模板_07

方法注释模板（注释模板的上的空行也算是模板的一部分不要更改，复制到指定位置并且一定保持与给出的模板一模一样，换行以及*以及*号之间的空格都要一一对应）

**
  * TODO
 $param$ 
  * @return $return$
  * @author Arnold
  * @throws	      
  *
**/

Template Variables具体参数对应表达式

Name	Expression
time	`date()`
methodName	`methodName()`
param	见下面的引用
return	`methodReturnType()`

上表的param表达式：groovyScript(“def result=‘’; def params=”${_1}“.replaceAll(‘[\\[|\\]|\\s]’, ‘’).split(‘,’).toList(); for(i = 0; i < params.size(); i++) {result+=’ * @param ’ + params[i] + ((i < params.size() - 1) ? ‘\r\n’ : ‘’)}; return result”, methodParameters())

在方法前面输入/m即可看到方法注释自动填充

IDEA 给Java代码设置规范 idea怎么规范代码格式_intellij idea_08