关于 Java 打包工具 jar 的接口形参名称丢失问题

一、症状

如图：



图中是谷歌二维码生成工具的某个接口，可以看到方法的形参已经变成不易阅读的 var XX 了，而且调用方法时的提示也只有 varXX。这篇博文就解决这个问题的。

二、实质

这种现象与打包工具无关，java 项目可以被打包成 XXX.jar 和 XXX-sources.jar 举个例子：

Junit 相关下载传送门



其实形参的可读性对机器识别和运行没有价值，所以从源码到可执行程序的过程中，会根据机器运行的需要做一些”优化”，即便这些对人来说带来了一些麻烦。所以通常情况下 jar 打包出来就是不包含接口等形参信息的。

那万一在开发阶段我还是想要得到形参信息怎么办呢？这个时候我们就需要引入 XXX-sources.jar 了。这种 jar 里是包含完整源码信息的，引入它就满足了我们的需求。



例如 IDEA 里可以这样引入。

三、如何打包出带源码信息的 jar

本文以 Maven 为例

在被打包项目 的 pom.xml 中核心内容

<project> <!--其他项目自定义配置省略-->
<build>
<plugins>
<plugin>
<artifactId>maven-source-plugin</artifactId>
<executions>
<execution>
<id>attch-sources</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
</plugin>
</plugins>
</build>
</project>

余下的操作和正常Maven 正常打包无任何区别可自行搜索