如何在Maven中转换XML为HTML并生成SureFire、PMD等工具的测试报告？

嘿，我来帮你搞定Maven里这些测试和质量报告的格式问题！下面分步骤给你讲清楚怎么转格式、直接生成HTML，还有自定义样式匹配你的示例页面。

其实Maven本身就有现成的插件来干这个活——maven-surefire-report-plugin，它能自动读取SureFire生成的XML测试结果（默认在target/surefire-reports目录），然后转换成美观的HTML报告。

你只需要在项目的pom.xml里添加这个插件的配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-report-plugin</artifactId>
      <version>3.2.5</version> <!-- 建议使用最新稳定版 -->
      <executions>
        <execution>
          <phase>test</phase> <!-- 绑定到test阶段，测试跑完自动生成报告 -->
          <goals>
            <goal>report</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

配置好之后，运行mvn test，测试结束后就会在target/site/surefire-report.html生成HTML报告了。如果不想绑定生命周期，也可以单独运行命令：mvn surefire-report:report。

上面的SureFire配置其实已经实现了“一步到位生成HTML”——你不用手动处理XML，Maven会帮你完成底层的转换。下面再单独讲SureFire和PMD的精细化配置，以及其他质量工具的通用思路。

2.1 SureFire直接生成HTML报告 #

如果想要更个性化的控制（比如指定报告输出目录），可以添加额外配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-report-plugin</artifactId>
  <version>3.2.5</version>
  <configuration>
    <outputDirectory>${project.build.directory}/my-custom-reports</outputDirectory> <!-- 自定义输出目录 -->
  </configuration>
</plugin>

2.2 PMD直接生成HTML报告 #

PMD默认会生成XML结果，但通过maven-pmd-plugin可以直接输出HTML报告。在pom.xml里添加配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-pmd-plugin</artifactId>
      <version>3.21.0</version>
      <executions>
        <execution>
          <phase>verify</phase> <!-- 绑定到verify阶段，代码检查完生成报告 -->
          <goals>
            <goal>pmd</goal> <!-- 生成PMD的检查结果（XML） -->
            <goal>pmd-report</goal> <!-- 自动把XML转成HTML报告 -->
          </goals>
        </execution>
      </executions>
      <configuration>
        <format>html</format> <!-- 指定输出格式为HTML -->
        <failOnViolation>false</failOnViolation> <!-- 可选：如果不想因为代码违规导致构建失败，设为false -->
      </configuration>
    </plugin>
  </plugins>
</build>

运行mvn verify后，HTML报告会出现在target/site/pmd.html。

其他质量控制工具（如Checkstyle、FindBugs） #

思路和PMD完全一致：每个工具对应的Maven插件都支持直接生成HTML报告，只需要在插件配置里指定format为html，或者调用对应的report目标。比如Checkstyle用maven-checkstyle-plugin的checkstyle-report目标，配置方式和PMD大同小异。

如果默认的HTML样式不符合你的示例页面要求，可以通过自定义XSL模板或者CSS来修改：

针对SureFire报告 #

SureFire的HTML报告是通过XSLT转换XML生成的，你可以先提取插件默认的XSL模板（从插件的jar包中获取），复制到项目目录后修改样式、布局，然后在插件配置里指定自定义模板：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-report-plugin</artifactId>
  <version>3.2.5</version>
  <configuration>
    <customStylesheet>${project.basedir}/src/main/resources/custom-surefire.xsl</customStylesheet>
  </configuration>
</plugin>

针对PMD报告 #

PMD同样支持自定义XSL模板，在插件配置里添加：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-pmd-plugin</artifactId>
  <version>3.21.0</version>
  <configuration>
    <xslLocation>${project.basedir}/src/main/resources/custom-pmd.xsl</xslLocation>
  </configuration>
</plugin>

另外，你也可以直接在自定义XSL里引入自己的CSS文件，或者修改生成的HTML文件中的样式，这种方式更灵活，适合快速匹配示例页面的视觉风格。

最后提醒：所有插件建议使用最新稳定版，避免兼容性问题。

内容的提问来源于stack exchange，提问作者Tlink