maven项目引入本地jar包史上最详细实践方法总结

日期	作者	版本	备注
2020-09-27	丁斌	V1.0

maven项目引入本地jar包问题从3个层面考虑：

1. IDE工具如Jetbrains IDEA考虑：

依次打开IDEA的File – Project Structure – Project Settings – Modules –
Dependencies 选项卡区域，点击右上角+号图标，选择1.JARS or
directories…，再选择java工程根目录下的lib或libs目录下，把所有需要本地引入的jar包都多选中，
然后点击OK即可。

2. Maven编译层面考虑：

在pom.xml文件中dependencies组件的最后部分添加如下图的本地依赖jar包。

注意scope为system表示本地的jar包。
systemPath为本地路径，一定要用${project.basedir}/开头引入，以表通用型。

以上3个地方如此修改后，联合的效果是，mvn clean package
后会target目录下生成一个lib目录，并且把所有的远程jar包和本地jar包都拷贝到lib目录下，以供后期java程序运行时找到之用。注意本地jar包会以上图中绿色框的约定的命名方式出现在lib目录下。

上图中true表明会在生成的目标jar文件中MANIFEST.MF中添加classpath如下图，lib
表明会给MANIFEST.MF中的classpath中每一个classpath加一个前缀lib.这些特性都非常重要。

因此组件下一共有3项:

以vim 打开生成的目标jar包vi mylucenedemo.jar:后：

光标放在MANIFEST.MF上按下回车，即可看到：

此外，如果有需要的话，java工程目标jar的运行可能还依赖于一些配置文件，通过pom.xml中profiles下的profile将其拷贝到target目录下的conf目录中去：

3. 目标jar程序执行层面考虑：

接下来，就可以在java工程的根目录下执行：mvn clean install -U, 会生成如下的target目录，有用的是conf目录，lib目录和目标文件mylucenedemo.jar.

执行方式是： 在target目录下直接执行java -jar mylucenedemo.jar即可。

会自动读取当前目下的lib子目录的所有依赖jar包，包括引入的本地jar包。以及conf目录下的所有配置文件。

最后，另附示例pox.xml: pom.xml, 提取码：h1e1。