我以为我编码很规范，但......

本以为自己写的代码应该还是挺规范的，当使用了checkstyle发现妥妥的打脸现场！由于公司要求我们在开发过程中规范代码 让我们使用checkstyle,刚开始我还是比较排斥（可能报红太多）但慢慢就真香了 用着用着心里不禁想（这东西可真太好用了）接下来我先说他怎么安装的再聊一聊他的一些规范和约束

1.安装（我开发工具是idea）

• 1.点击File -> Settings -> Tools 查看是否有Checkstyle若没有请接着看

• 2.点击File -> Settings -> Plugins 可以在Marketplace中搜索checkstyle下载，也可以先下载CheckStyle安装包，再点击这个将这个压缩包导入即可（这个的速度更快 推荐）具体的安装可以官网取下载

• 3.再次点击Tools查看是否有CheckStyle(正常情况下是有的)点击CheckStyle

将checkstyle的一个约束文件导入（alibaba_checks.xml文件）点击Apply即可生效 xml文件可以直接网上搜索 如下图所示：

2.看看xml

alibaba_checks.xml文件 若需要可以直接复制使用

我在这里分享一些我在开发中经常会检测出的一些约束：

1.import检查 "UnusedImports":在开发中有时有些包是无用导入他会检测出来

2.命名检查：如命名包名只能是小写字母（PackageName），还有类名方法名常量名等检查、

3.方法的参数个数不超过5个：若参数多其实建议传对象

4.除此之外还有一些代码语法的检查 `

<!-- 检查文件是否以一个空行结束 -->
<module name="NewlineAtEndOfFile"/>

<!-- 文件长度不超过1500行 -->
<module name="FileLength">
    <property name="max" value="1500"/>
</module>

<!-- 每个java文件一个语法树 -->
<module name="TreeWalker">
    <!-- import检查-->
    <!-- 检查是否从非法的包中导入了类 -->
    <module name="IllegalImport"/>
    <!-- 检查是否导入了多余的包 -->
    <module name="RedundantImport"/>
    <!-- 没用的import检查，比如：1.没有被用到2.重复的3.import java.lang的4.import 与该类在同一个package的 -->
    <module name="UnusedImports" />

    <!-- 注释检查 -->
    <!-- 检查构造函数的javadoc -->
    <module name="JavadocType">
        <property name="allowUnknownTags" value="true"/>
        <message key="javadoc.missing" value="类注释：缺少Javadoc注释。"/>
    </module>

    <!-- 命名检查 -->
    <!-- 局部的final变量，包括catch中的参数的检查 -->
    <module name="LocalFinalVariableName" />
    <!-- 局部的非final型的变量，包括catch中的参数的检查 -->
    <module name="LocalVariableName" />
    <!-- 包名的检查（只允许小写字母），默认^[a-z]+(\.[a-zA-Z_][a-zA-Z_0-9_]*)*$ -->
    <module name="PackageName">
        <property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$" />
        <message key="name.invalidPattern" value="包名 ''{0}'' 要符合 ''{1}''格式."/>
    </module>
    <!-- 仅仅是static型的变量（不包括static final型）的检查 -->
    <module name="StaticVariableName" />
    <!-- Class或Interface名检查，默认^[A-Z][a-zA-Z0-9]*$-->
    <module name="TypeName">
        <message key="name.invalidPattern" value="名称 ''{0}'' 要符合 ''{1}''格式."/>
    </module>
    <!-- 非static型变量的检查 -->
    <module name="MemberName" />
    <!-- 方法名的检查 -->
    <module name="MethodName" />
    <!-- 方法的参数名 -->
    <module name="ParameterName " />
    <!-- 常量名的检查（只允许大写），默认^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$ -->
    <module name="ConstantName" />

    <!-- 定义检查 -->
    <!-- 检查数组类型定义的样式 -->
    <module name="ArrayTypeStyle"/>
    <!-- 检查long型定义是否有大写的“L” -->
    <module name="UpperEll"/>

    <!-- 长度检查 -->
    <!-- 每行不超过140个字符 -->
    <!-- <module name="LineLength">
        <property name="max" value="140" />
    </module> -->
    <!-- 方法不超过50行 -->
    <!-- <module name="MethodLength">
        <property name="tokens" value="METHOD_DEF" />
        <property name="max" value="50" />
    </module> -->
    <!-- 方法的参数个数不超过5个。并且不对构造方法进行检查-->
    <module name="ParameterNumber">
        <property name="max" value="5" />
        <property name="ignoreOverriddenMethods" value="true"/>
        <property name="tokens" value="METHOD_DEF" />
    </module>

    <!-- 空格检查-->
    <!-- 方法名后跟左圆括号"(" -->
    <module name="MethodParamPad" />
    <!-- 在类型转换时，不允许左圆括号右边有空格，也不允许与右圆括号左边有空格 -->
    <module name="TypecastParenPad" />
    <!-- 检查在某个特定关键字之后应保留空格 -->
    <module name="NoWhitespaceAfter"/>
    <!-- 检查在某个特定关键字之前应保留空格 -->
    <module name="NoWhitespaceBefore"/>
    <!-- 操作符换行策略检查 -->
    <module name="OperatorWrap"/>
    <!-- 圆括号空白 -->
    <module name="ParenPad"/>
    <!-- 检查分隔符是否在空白之后 -->
    <module name="WhitespaceAfter"/>
    <!-- 检查分隔符周围是否有空白 -->
    <module name="WhitespaceAround"/>

    <!-- 修饰符检查 -->
    <!-- 检查修饰符的顺序是否遵照java语言规范，默认public、protected、private、abstract、static、final、transient、volatile、synchronized、native、strictfp -->
    <module name="ModifierOrder"/>
    <!-- 检查接口和annotation中是否有多余修饰符，如接口方法不必使用public -->
    <module name="RedundantModifier"/>

    <!-- 代码块检查 -->
    <!-- 检查是否有嵌套代码块 -->
    <module name="AvoidNestedBlocks"/>
    <!-- 检查是否有空代码块 -->
    <module name="EmptyBlock"/>
    <!-- 检查左大括号位置 -->
    <module name="LeftCurly"/>
    <!-- 检查代码块是否缺失{} -->
    <module name="NeedBraces"/>
    <!-- 检查右大括号位置 -->
    <module name="RightCurly"/>

    <!-- 代码检查 -->
    <!-- 检查空的代码段 -->
    <module name="EmptyStatement"/>
    <!-- 检查在重写了equals方法后是否重写了hashCode方法 -->
    <module name="EqualsHashCode"/>
    <!-- 检查局部变量或参数是否隐藏了类中的变量 -->
    <module name="HiddenField">
        <property name="tokens" value="VARIABLE_DEF"/>
    </module>
    <!-- 检查子表达式中是否有赋值操作 -->
    <module name="InnerAssignment"/>
    <!-- 检查switch语句是否有default -->
    <module name="MissingSwitchDefault"/>
    <!-- 检查是否有过度复杂的布尔表达式 -->
    <module name="SimplifyBooleanExpression"/>
    <!-- 检查是否有过于复杂的布尔返回代码段 -->
    <module name="SimplifyBooleanReturn"/>

    <!-- 类设计检查 -->
    <!-- 检查类是否为扩展设计l -->
    <!-- 检查只有private构造函数的类是否声明为final -->
    <module name="FinalClass"/>
    <!-- 检查接口是否仅定义类型 -->
    <module name="InterfaceIsType"/>
    <!-- 检查类成员的可见度 检查类成员的可见性。只有static final 成员是public的
    除非在本检查的protectedAllowed和packagedAllowed属性中进行了设置-->
    <module name="VisibilityModifier">
        <property name="packageAllowed" value="true"/>
        <property name="protectedAllowed" value="true"/>
    </module>

    <!-- 语法 -->
    <!-- String的比较不能用!= 和 == -->
    <module name="StringLiteralEquality"/>
    <!-- 限制for循环最多嵌套2层 -->
    <module name="NestedForDepth">
        <property name="max" value="2"/>
    </module>
    <!-- if最多嵌套3层 -->
    <module name="NestedIfDepth">
        <property name="max" value="3"/>
    </module>
    <!-- 检查未被注释的main方法,排除以Appllication结尾命名的类 -->
    <module name="UncommentedMain">
        <property name="excludedClasses" value=".*[Application,Test]$"/>
    </module>
    <!-- 禁止使用System.out.println -->
    <!-- <module name="Regexp">
        <property name="format" value="System\.out\.println"/>
        <property name="illegalPattern" value="true"/>
    </module> -->
    <!-- return个数 3个-->
    <!-- <module name="ReturnCount">
        <property name="max" value="3"/>
    </module> -->
    <!--try catch 异常处理数量 3-->
    <module name="NestedTryDepth ">
        <property name="max" value="3"/>
    </module>
    <!-- clone方法必须调用了super.clone() -->
    <module name="SuperClone" />
    <!-- finalize 必须调用了super.finalize() -->
    <module name="SuperFinalize" />


</module>
复制代码

`

总结

代码检查只是让我们在编程中能够养成良好的开发习惯，其实这个用了一段时间后自己也就习惯了 在编码过程中自己就会注意到这些规范问题。规范代码方便自己也让别人方便

作者：又菜又想玩的XXX
链接：https://juejin.cn/post/7012419799653285896
来源：掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。