摘要:近来项目组在搞代码检查,所以领导让把checkstyle这个插件搞明白,现在我把我们写的自定义的checkstyle.xml文件记录一下,以便大家可以一起使用:
一:要使用checkstyle插件在eclipse中检查java代码,那必须的先安装eclipse的checkstyle插件,如何安装,我相信大家知道,这里就不多说了
二:下面就是自定义的checkstyle.xml文件(这个是核心)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE module PUBLIC "-//Puppy Crawl//DTD Check Configuration 1.3//EN" "http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
<!--
This configuration file was written by the eclipse-cs plugin configuration editor
-->
<!--
Checkstyle-Configuration: check
Description: none
-->
<module name="Checker">
<property name="severity" value="error"/>
<property name="charset" value="UTF-8"/>
<message key="general.exception" value="有一个异常 - {0} "/>
<message key="general.fileNotFound" value="文件没找到!"/>
<!--章节2.2A -->
<!-- 不允许使用TAB缩进,此规则必须在<TreeWalker>标签外 -->
<module name="FileTabCharacter">
<property name="severity" value="error"/>
<property name="eachLine" value="true"/>
<message key="containsTab" value="本行包含 tab 字符,违反编码规范2.2章节"/>
</module>
<!--章节3.1.1 -->
<!-- 检查每个java package中是否有java注释文件,默认是允许一个package-info.java,
也可以通过allowLegacy属性配置允许package.html。此规则必须在<TreeWalker>标签外 -->
<module name="JavadocPackage" />
<module name="TreeWalker">
<property name="severity" value="error"/>
<property name="tabWidth" value="4"/>
<message key="general.exception" value="有一个异常 - {0}"/>
<!--章节1.2.2 -->
<!-- 修饰符顺序检测 -->
<module name="ModifierOrder">
<message key="mod.order" value="''{0}'' 修饰符顺序错误.违反编码规范1.2.2章节"/>
<message key="annotation.order" value="''{0}'' 注释修饰符不能在非注释修饰符前面."/>
</module>
<!--章节2.2B -->
<!-- 缩进风格-->
<module name="Indentation">
<property name="severity" value="error"/>
<property name="basicOffset" value="4"/>
<message key="indentation.error" value="你缩进了{1}个空格,正确应该缩进 {2}个空格,违反编码规范2.2章节"/>
<!-- 子级缩进 -->
<message key="indentation.child.error" value="你缩进了{1}个空格,正确应该缩进 {2}个空格,违反编码规范2.2章节"/>
</module>
<!--章节2.3 -->
<!-- 页宽-->
<module name="LineLength">
<property name="max" value="80"/>
<message key="maxLineLen" value="行字符数超过80个.违反编码规范2.3章节"/>
</module>
<!--章节2.4 -->
<!--操作符换行策略检查-->
<module name="OperatorWrap">
<property name="severity" value="error"/>
<property name="option" value="nl"/>
<property name="tokens" value="ASSIGN,BAND,BOR,DIV,EQUAL,GE,GT,LAND,LE,LOR,LT,MINUS_ASSIGN,MOD,MOD_ASSIGN,NOT_EQUAL,PLUS,PLUS_ASSIGN,QUESTION,STAR,STAR_ASSIGN"/>
<message key="line.after" value="''{0}'没有放在新行之首,违反编码规范2.4章节"/>
</module>
<!--章节2.6 -->
<module name="ParenPad">
<property name="severity" value="error"/>
<property name="tokens" value="LPAREN,RPAREN,CTOR_CALL,METHOD_CALL,SUPER_CTOR_CALL"/>
<message key="ws.followed" value="''{0}'' 后面有空格,违反编码规范2.6章节"/>
<message key="ws.preceded" value="''{0}''前面有空格,违反编码规范2.6章节"/>
</module>
<module name="TypecastParenPad">
<property name="severity" value="error"/>
<property name="tokens" value="RPAREN,TYPECAST"/>
<message key="ws.followed" value="''{0}''后面多一个空格,违反编码规范2.6章节"/>
<message key="ws.preceded" value="''{0}''前面多一个空格,违反编码规范2.6章节"/>
</module>
<module name="WhitespaceAfter">
<property name="severity" value="error"/>
<property name="tokens" value="COMMA,SEMI"/>
<message key="ws.notFollowed" value="''{0}''后面多一个空格,违反编码规范2.6章节"/>
</module>
<module name="WhitespaceAround">
<property name="severity" value="error"/>
<property name="tokens" value="RCURLY,LITERAL_ASSERT,LITERAL_ASSERT,LITERAL_CATCH,LITERAL_DO,LITERAL_ELSE,LITERAL_FINALLY,LITERAL_FOR,LITERAL_IF,LITERAL_RETURN,LITERAL_SYNCHRONIZED,LITERAL_TRY,LITERAL_WHILE"/>
<property name="allowEmptyConstructors" value="true"/>
<property name="allowEmptyMethods" value="true"/>
<message key="ws.notPreceded" value="''{0}'' 关键字前少一个空格,违反编码规范2.6章节"/>
<message key="ws.notFollowed" value="''{0}'' 关键字后少一个空格,违反编码规范2.6章节"/>
</module>
<!--章节2.7 -->
<!-- 每行语句数量-->
<module name="OneStatementPerLine">
<!--模块的元数据类型设置,经过测试发现该标签没用-->
<metadata name="net.sf.eclipsecs.core.comment" value="Coding Problems-> Only one statement per line allowed" />
<message key="multiple.statements.line" value="禁止一行有多句代码,违反编码规范2.7章节" />
</module>
<!--章节2.8 -->
<!-- 每行变量声明数量-->
<module name="MultipleVariableDeclarations">
<property name="severity" value="error"/>
<message key="multiple.variable.declarations.comma" value="每一个变量的定义必须在它的声明处,且在同一行,违反编码规范2.8章节"/>
<message key="multiple.variable.declarations" value="每一行只能定义一个变量,违反编码规范2.8章节"/>
</module>
<!--章节2.9.1 -->
<!-- Checks the placement of right curly braces ('}') for else, try, and catch tokens. The policy to verify is specified using property option.
option: 右大括号是否单独一行显示
tokens: 定义检查的类型 -->
<module name="RightCurly">
<property name="option" value="alone"/>
<property name="severity" value="error"/>
</module>
<!--章节2.9.1 -->
<!-- 检查左侧大括号 左侧大括号必须放在前一行代码的行尾 -->
<module name="LeftCurly">
<property name="severity" value="error"/>
<message key="line.previous" value="左侧大括号没有放在前一行代码的行尾,违反编码规范2.9.1章节"/>
</module>
<!--章节2.9.2 -->
<!-- 检查代码块是否缺失大括号-->
<module name="NeedBraces">
<message key="needBraces" value="''{0}'' 结构没有用大括号 '''{}'''s,违反编码规范2.9.2章节"/>
</module>
<!-- 章节3.2 -->
<!-- 对文件头的注释进行检查 -->
<!--章节3.3 -->
<!--对类和接口的javadoc注释进行检查-->
<module name="JavadocType">
<property name="severity" value="error"/>
<message key="type.missingTag" value="Javadoc 类型的注释丢失 {0} 标签.违反编码规范3.3章节"/>
<message key="javadoc.missing" value="缺少 Javadoc 注释.违反编码规范3.3章节"/>
<message key="javadoc.unusedTagGeneral" value="未使用过的 Javadoc 标签.违反编码规范3.23章节"/>
<message key="javadoc.unusedTag" value="未使用过的 {0} 标签for ''{1}''.违反编码规范3.3章节"/>
<message key="type.tagFormat" value="Javadoc 类型标签 {0}必须匹配模式 ''{1}''.违反编码规范3.3章节"/>
</module>
<!--章节3.4,3.7 -->
<!--public protect private变量的注释进行检查-->
<module name="JavadocVariable">
<property name="severity" value="error"/>
<property name="scope" value="public"/>
<message key="javadoc.missing" value="变量注释:缺少Javadoc注释,违反编码规范3.4章节"/>
</module>
<module name="JavadocVariable">
<property name="severity" value="error"/>
<property name="scope" value="protected"/>
<message key="javadoc.missing" value="变量注释:缺少Javadoc注释,违反编码规范3.4章节"/>
</module>
<module name="JavadocVariable">
<property name="severity" value="error"/>
<message key="javadoc.missing" value="变量注释:缺少Javadoc注释,违反编码规范3.4章节"/>
</module>
<!--章节3.5 -->
<!-- 检查所有方法的javadoc,可以不声明RuntimeException -->
<module name="JavadocMethod">
<property name="allowUndeclaredRTE" value="true"/>
<!--允许get set 方法没有注释-->
<property name="allowMissingPropertyJavadoc" value="true"/>
<message key="javadoc.missing" value="方法注释:缺少Javadoc注释,违反编码规范3.5章节"/>
</module>
<!-- 命名规范 -->
<!--章节4.2 -->
<!-- 包名命名规范 -->
<module name="PackageName">
<!-- <property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$"/> -->
<property name="format" value="^org\.neris\.[a-z]+(\.[a-z]+)+$"/>
<message key="name.invalidPattern" value="包名 ''{0}'' 不符合org.neris.项目名.模块名,违反编码规范4.2章节"/>
</module>
<!--章节4.3,4.4 -->
<!-- 类的命名,匹配规则默认:(^[A-Z][a-zA-Z0-9]*$),必须以大写字母开始 -->
<module name="TypeName">
<property name="tokens" value="CLASS_DEF"/>
<message key="name.invalidPattern" value="类名 ''{0}''没有通过大驼峰命名法命名,具体名称应使用意义完整的英文描述,违反编码规范4.3章节"/>
</module>
<!-- 接口命名,匹配规则默认:(^[A-Z][a-zA-Z0-9]*$),必须以大写字母开始 -->
<module name="TypeName">
<property name="tokens" value="INTERFACE_DEF"/>
<message key="name.invalidPattern" value="接口名 ''{0}''没有通过大驼峰命名法命名,具体名称应使用意义完整的英文描述,违反编码规范4.3章节"/>
</module>
<!--章节4.6 -->
<!-- 方法名命名 -->
<module name="MethodName">
<property name="severity" value="error"/>
<property name="format" value="(^[a-z][a-zA-Z0-9]*$)"/>
<message key="name.invalidPattern" value="方法名 ''{0}''没有通过小驼峰命名法命名,具体名称应使用意义完整的英文描述.违反编码规范4.6章节"/>
</module>
<!--章节4.7 -->
<!-- 局部变量命名 -->
<module name="LocalVariableName">
<property name="format" value="(^[a-z][a-zA-Z0-9]*$)"/>
<message key="name.invalidPattern" value="变量名 ''{0}''没有通过小驼峰命名法命名,具体名称应使用意义完整的英文描述.违反编码规范4.7章节"/>
</module>
<!-- 局部的final变量,包括catch中的参数的检查 -->
<module name="LocalFinalVariableName" >
<property name="severity" value="error"/>
<message key="name.invalidPattern" value="变量名 ''{0}''没有通过小驼峰命名法命名,具体名称应使用意义完整的英文描述.违反编码规范4.7章节"/>
</module>
<!-- 变量命名 -->
<module name="MemberName">
<message key="name.invalidPattern" value="变量名 ''{0}''没有通过小驼峰命名法命名,具体名称应使用意义完整的英文描述.违反编码规范4.7章节"/>
</module>
<!-- 静态变量命名 -->
<module name="StaticVariableName">
<message key="name.invalidPattern" value="变量名 ''{0}''没有通过小驼峰命名法命名,具体名称应使用意义完整的英文描述.违反编码规范4.7章节"/>
</module>
<!-- 数组变量命名 -->
<module name="ArrayTypeStyle">
<property name="severity" value="error"/>
<message key="array.type.style" value="数组定义没有采取int[] index这种方式,违反编码规范4.7.2章节"/>
</module>
<!--章节4.8 -->
<!-- 常量命名-->
<module name="ConstantName">
<property name="severity" value="error"/>
<message key="name.invalidPattern" value="常量 ''{0}'' 常量名违反编码规范4.8章节."/>
</module>
<!--章节5.1 -->
<!-- import语句不使用通配符 -->
<module name="AvoidStarImport">
<property name="severity" value="error"/>
<message key="import.avoidStar" value="引用包时不能使用*号.违反编码规范5.1章节"/>
</module>
<!--章节5.2 -->
<!-- 魔法数检测-->
<module name="MagicNumber">
<property name="severity" value="error"/>
<message key="magic.number" value="''{0}'' 是一个魔法数(即常数).违反编码规范5.2章节"/>
</module>
<!--章节5.4 -->
<!-- 多余的关键字,包含不适用this作为关键字 -->
<module name="RedundantModifier">
<message key="redundantModifier" value="''{0}'' 多余的修饰符.违反编码规范5.4章节"/>
</module>
<!--章节5.5 -->
<!-- 重载父类方法 -->
<module name="MissingOverride">
<message key="annotation.missing.override" value="重载方法缺少@Override,违反编码规范5.5章节" />
<message key="tag.not.valid.on" value="注释-> Javadoc {0}标签在这个位置是无效的." />
</module>
<!--章节5.6 -->
<!--判断语句使用 -->
<module name="SimplifyBooleanExpression">
<property name="severity" value="error"/>
<message key="simplify.expression" value="存在布尔冗余,违法编码规范5.6章节."/>
</module>
<!--章节5.7 -->
<!-- 检查switch语句是否忘记了default标签 -->
<module name="MissingSwitchDefault" >
<property name="severity" value="error"/>
<message key="missing.switch.default" value="switch 语句后边没有 default 语句.违法编码规范5.7章节"/>
</module>
<!-- 检查switch语句中default标签的顺序 -->
<module name="DefaultComesLast">
<property name="severity" value="error"/>
<message key="default.comes.last" value="建议Default 放在 switch 语句的最后."/>
</module>
<!--章节5.9 -->
<!-- 禁止使用System.out.println -->
<module name="Regexp">
<property name="format" value="System\.out\.println"/>
<property name="message" value="不要使用 System.out 与 System.out 进行控制台打印,应该使用日志工具类(如:log4j)进行统一记录或者打印,违法编码规范5.9章节"/>
<property name="illegalPattern" value="true"/>
</module>
<!-- 禁止使用System.err.println -->
<module name="Regexp">
<property name="format" value="System\.err\.println"/>
<property name="message" value="不要使用 System.out 与 System.err 进行控制台打印,应该使用日志工具类(如:log4j)进行统一记录或者打印,违法编码规范5.9章节"/>
<property name="illegalPattern" value="true"/>
</module>
<!--章节5.10 -->
<!-- 不允许用main方法测试-->
<module name="UncommentedMain">
</module>
<!--章节5.11 -->
<!-- NeedBraces 检查是否应该使用括号的地方没有加括号
tokens: 定义检查的类型 -->
<module name="NeedBraces"/>
</module>
</module>
三:安装好eclipse的checkstyle插件后,你就可以把checkstyle.xml文件添加进去,如何添加,网上有很多文档