02.Spotless代码格式化工具

Spotless代码格式化工具

1.为什么需要

在一些大型项目或开源项目,由于开发人员太多,导致各个代码格式不统一。会让整体项目的代码可读性变差,那么如何可以统一代码格式呢?

使用Spotless就可以完成

2.是什么

Spotless 是支持多种语言的代码格式化工具(自动或手动方式均可),支持 Maven 和 Gradle 以 Plugin 的形式构建。目前 github 已经有 4000+ 开源项目在使用 Spotless 进行格式化代码

3.github地址

https://github.com/diffplug/spotless/tree/main/plugin-maven

4.代码格式化方式

Spotless 提供了多种 Java 代码格式化方式,如 googleJavaFormat、eclipse、prettier 等

5.使用方式

  1. Maven插件整合
  2. Gradle插件整合

6.Maven整合Spotless

目标

自动为代码添加 licenseHeader 和格式化代码

步骤

  1. 在父POM文件中引入插件依赖
  2. 创建代码格式文件
  3. 手动执行代码格式化
  4. 将格式化绑定到 Maven 生命周期

在父POM文件中引入插件依赖

            <!-- spotless插件 -->
            <plugin>
                <groupId>com.diffplug.spotless</groupId>
                <artifactId>spotless-maven-plugin</artifactId>
                <version>2.22.1</version>
                <configuration>
                    <java>
                        <eclipse>
                            <file>dev-support/spotless_formatter.xml</file>
                        </eclipse>
                        <!-- 我这里没添加头要是需要就添加上 -->
<!--                        <licenseHeader>-->
<!--                            <file>dev-support/license-header</file>-->
<!--                        </licenseHeader>-->
                    </java>
                </configuration>
            </plugin>

创建代码格式化文件

在 dev-support 中创建 spotless_formatter.xml 文件,用于指定 Eclipse 代码格式化的设置

具体内容省略,请自行百度或谷歌

手动执行代码格式化

经过上述步骤,我们就可以执行以下命令来检查 Java 代码是否符合规范并进行格式化:

# 查看哪些代码不符合代码格式
mvn spotless:check

# 代码格式化
mvn spotless:apply

当然,我们也可以直接在 IDEA 中使用 Maven 插件来执行这些操作。只需点击一下,即可完成整个过程

在这里插入图片描述

将格式化绑定到 Maven 生命周期

在实际应用中,我选择将 Spotless 格式化操作绑定到 compile 阶段,这样当执行 mvn install 时,代码会自动进行格式化

以下是在 POM 文件中配置的相关部分:

 <!--此插件用于格式化代码,mvn spotless:check mvn spotless:apply -->
    <plugin>
      <groupId>com.diffplug.spotless</groupId>
      <artifactId>spotless-maven-plugin</artifactId>
      <version>${spotless-maven-plugin.version}</version>
      <configuration>
        <java>
          <eclipse>
            <file>dev-support/spotless_formatter.xml</file>
          </eclipse>
          <licenseHeader>
            <file>dev-support/license-header</file>
          </licenseHeader>
        </java>
      </configuration>

      <executions>
        <execution>
          <goals>
            <goal>apply</goal>
          </goals>
          <phase>compile</phase>
        </execution>
      </executions>

    </plugin>

补充头文件内容

在 dev-support 文件夹中创建头文件 license-header,内容如下:

/*
 * DailyMart is a microservice-based e-commerce project implemented
 * with Domain-Driven Design (DDD).
 * Copyright (C) 2023 Java日知录
 *
 * ...
 */
 

这样,当使用 Spotless 进行代码格式化时,会为所有代码文件添加这段头信息。请注意,在头文件后面留一个空行,以确保 licenseHeader 与 Java 代码的 package 之间有足够的间隔,以保持代码的美观性

7.集成IDEA插件完成单文件格式化

为什么需要

如果开发者在编写代码时想要检查单个文件是否符合规范,执行 mvn spotless:check 或 mvn spotless:apply 或许稍显繁琐,因为默认格式化范围是整个项目

但是,我们可以借助 IDEA 的插件 Adapter for Eclipse Code Formatter 来实现单个文件的格式化。只需将我们的自定义代码文件替换原文件即可

安装

在这里插入图片描述

设置

修改代码格式化文件,将自定义的代码风格导入

在这里插入图片描述

这样,您就可以使用 IDEA 的快捷键对单个文件进行代码格式化,同时使用的是您自定义的代码风格