Maven插件方式执行CheckStyle并自定义风格文件

Maven插件方式执行CheckStyle并自定义风格文件

一、写在前面

代码风格包含了变量的命名,缩进,注释等内容,在团队开发中,多人协同开发要避免各种风格混合带来的混乱,统一的代码风格是必须的。在开发过程中,我们可以使用一些工具来改进这一状况,比如 checkStyle 工具。

二、开始

Checkstyle 是一种用于检查 Java 源代码是否遵守代码标准或验证规则集(最佳实践)的工具。

它由这些组成:

执行程序:即 checkStyle 的执行程序,它可以再 IDEA 编辑器中启动,也可以在 Maven 插件方式启动,也可以二进制方式启动。代码风格描述规则:以 XML 方式描述的代码风格的规则,比如sun_checks.xml 这个文件。相关的配置文件:比如在使用Maven插件时,插件的配置文件需要配置。

checkStyle 可以通过多种方式使用

(1) Maven 插件使用(2) Idea 编辑器中使用,请参考:https://www.jianshu.com/p/5f082a91e411 (3) 二进制应用启动(本文略)

我个人更喜欢在 Maven 插件 的方式使用,代码编写完执行一次,需要更改地方会在执行结果中告诉我,然后再修正遇到的问题。

我这里推荐 作者blinkfox 修改的代码风格规则文件,作者很用心,根据google的风格进行了修改,比如缩进(谷歌是2个空格缩进,而我也习惯了4个空格缩进),同时编写了中文的风格说明,非常赞。 更多请参考: blinkfox-checks.md

Maven 插件方式使用CheckStyle(1) 下载 一个 规则文件

在这里下载 一个 google_checks.xml 文件 下载地址:https://github.com/blinkfox/java-style/tree/master/docs/styles

(2) 配置Maven插件 true org.apache.maven.plugins maven-checkstyle-plugin 3.1.2 com.puppycrawl.tools checkstyle 9.3 ${checkstyle.skip} style/blinkfox-checks.xml UTF-8 true true false false validate validate check

疑问:我这里添加了自定义属性 checkstyle.skip,为什么呢? 解答:配置了checkstyle后,它会在 maven 构建的 验证阶段执行,如果失败,会导致编译失败。我这里不想让它默认执行,仅在 希望执行的时候执行,因此默认是不执行的,只有 ${checkstyle.skip} 是 true 的时候执行,通过 -Dcheckstyle.skip=false 进行传参。

(3) 执行 CheckStylemvn checkstyle:check -Dcheckstyle.skip=false三、扩展3.1 跳过代码检查

mvn install 时可以跳过代码检查,使用 用 checkstyle.skip 来做:

mvn clean install -Dcheckstyle.skip -Dmaven.test.skip3.2 CheckStyle 配置详解

请参考:https://www.pudn.com/news/6306d065f8728f1f6c829ae9.html

四、参考

Blinkfox Java 编程风格指南,且包含 CheckStyle 和 IDEA 格式化文件,作者很用心 https://github.com/blinkfox/java-style

https://juejin.cn/post/7178683426852044858?share_token=8408902a-f460-4642-b312-e7e661a9878d

谷歌开发指南,英文: https://google.github.io/styleguide/javaguide.html

https://juejin.cn/post/7178683426852044858?share_token=8408902a-f460-4642-b312-e7e661a9878d

下载google_checks.xml 文件 https://github.com/checkstyle/checkstyle/blob/master/src/main/resources/google_checks.xml

Google 开源项目风格指南——中文版 https://zh-google-styleguide.readthedocs.io/en/latest/google-javascript-styleguide/javascript_language_rules/#var

https://zh-google-styleguide.readthedocs.io/en/latest/google-javascript-styleguide/javascript_language_rules/#var


比丘资源网 » Maven插件方式执行CheckStyle并自定义风格文件

发表回复

提供最优质的资源集合

立即查看 了解详情