关于 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 正常打包无任何区别可自行搜索