<think>我们正在处理一个关于
Maven的问题：如何将
本地JAR包打包到
Maven项目中。根据提供的
引用，我们可以总结出几种方法，并给出步骤。
方法一：将
本地JAR安装到
本地Maven仓库
这是推荐的方法，因为它允许你像管理其他依赖一样管理
本地JAR。
步骤：
1. 使用
mvn install:
install-file命令将
本地JAR安装到
本地仓库。
命令格式：
```
mvn install:
install-file -Dfile=<path-to-
jar> -DgroupId=<group-id> -DartifactId=<artifact-id> -Dversion=<version> -Dpackaging=
jar
```
例如：
```
mvn install:
install-file -Dfile=./lib/example.
jar -DgroupId=com.example -DartifactId=example -Dversion=1.0.0 -Dpackaging=
jar
```
2. 在
项目的
pom.xml中添加依赖：
```xml
<dependency>
<groupId>com.example</groupId>
<artifactId>example</artifactId>
<version>1.0.0</version>
</dependency>
```
方法二：使用system作用域（不推荐，因为可能导致可移植性问题）
步骤：
1. 将
JAR包放在
项目目录中，例如lib目录。
2. 在
pom.xml中添加依赖，并指定作用域为system：
```xml
<dependency>
<groupId>com.example</groupId>
<artifactId>example</artifactId>
<version>1.0.0</version>
<scope>system</scope>
<systemPath>${project.basedir}/lib/example.
jar</systemPath>
</dependency>
```
3. 注意：使用system作用域的依赖不会被传递，也不会被
打包到
生成的
JAR中（除非使用下面的插件）。
方法三：使用
Maven Shade插件将依赖
打包到最终的
JAR中（适用于方法一和方法二，但方法二需要额外配置）
如果你使用方法一，那么常规的
打包插件（如
maven-assembly-plugin或
maven-shade-plugin）就可以将依赖
打包进去。
如果你使用方法二，那么需要配置
maven-shade-plugin来
包含system作用域的依赖。
配置
maven-shade-plugin的示例（在
pom.xml的build/plugins部分）：
```xml
<build>
<plugins>
<plugin>
<groupId>org.apache.
maven.plugins</groupId>
<artifactId>
maven-shade-plugin</artifactId>
<version>3.2.4</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<!-- 如果需要
包含system作用域的依赖，则添加以下配置 -->
<includeSystemScope>true</includeSystemScope>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
```
但是，注意
引用[4]中提到，即使配置了编译时使用
本地jar，
打包时可能还会报错。所以更推荐使用方法一，然后使用shade插件
打包。
另外，
引用[4]还提到在编译插件中配置extdirs，但这种方法已经过时，而且不推荐。我们应优先使用安装到
本地仓库的方式。
总结：
推荐使用第一种方法，将
本地JAR安装到
本地仓库，然后作为普通依赖引入，再使用shade插件
打包（如果需要uber
jar）。这样能保证
项目的可移植性。
相关问题：
1. 如何将
本地JAR包安装到
Maven本地仓库？
2. 使用system作用域引入
本地JAR有什么缺点？
3. 如何配置
Maven Shade插件来
打包所有依赖？</think>### 如何在
Maven 项目中引入
本地 JAR 包并
打包到最终构建
#### 方法一：安装到
本地仓库（推荐）
1. **将
JAR 安装到
Maven 本地仓库**
执行命令（参数需替换为实际值）：
```shell
mvn install:
install-file -Dfile=路径/
包名.
jar \
-DgroupId=自定义GroupId \
-DartifactId=自定义ArtifactId \
-Dversion=版本号 \
-Dpackaging=
jar
```
示例：
```shell
mvn install:
install-file -Dfile=./lib/algo-utils.
jar \
-DgroupId=com.example \
-DartifactId=algo-utils \
-Dversion=1.0.0
```
2. **在 `
pom.xml` 中添加依赖**
```xml
<dependency>
<groupId>com.example</groupId>
<artifactId>algo-utils</artifactId>
<version>1.0.0</version>
</dependency>
```
此时
JAR 会像公共
仓库依赖一样参与编译和
打包[^2]。
---
#### 方法二：使用 `system` 作用域（需配合
打包插件）
1. **将
JAR 放入
项目目录**（如 `lib/`）
2. **在 `
pom.xml` 声明依赖**
```xml
<dependency>
<groupId>com.example</groupId>
<artifactId>local-lib</artifactId>
<version>1.0</version>
<scope>system</scope>
<systemPath>${project.basedir}/lib/local-lib.
jar</systemPath>
</dependency>
```
3. **配置
Maven Shade 插件
打包**
```xml
<build>
<plugins>
<plugin>
<groupId>org.apache.
maven.plugins</groupId>
<artifactId>
maven-shade-plugin</artifactId>
<version>3.4.1</version>
<executions>
<execution>
<phase>package</phase>
<goals><goal>shade</goal></goals>
<configuration>
<includeSystemScope>true</includeSystemScope> <!-- 关键配置 -->
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
```
执行 `
mvn package` 后，
本地 JAR 会被
包含在最终
JAR 中[^2][^3]。
---
#### 方法三：直接编译
包含（不推荐）
```xml
<build>
<plugins>
<plugin>
<groupId>org.apache.
maven.plugins</groupId>
<artifactId>
maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<compilerArgs>
<arg>-extdirs</arg>
<arg>${project.basedir}/lib</arg> <!-- 指定
JAR目录 -->
</compilerArgs>
</configuration>
</plugin>
</plugins>
</build>
```
> ⚠️ 注意：此方式仅解决编译问题，
打包仍需额外配置 Shade 插件[^4]。
---
### 最佳实践建议
1. **优先选择方法一**
将
本地 JAR 安装到
仓库可保持
项目结构清晰，避免路径问题[^2]。
2. **避免直接
引用文件路径**
`system` 作用域会导致
项目可移植性降低（如 CI/CD 环境可能缺失
文件）[^3]。
3. **关键插件配置**
Shade 插件的 `<includeSystemScope>true</includeSystemScope>` 是
打包 `system` 依赖的核心[^2]。
最终
项目结构示例：
```
project-root
├── lib/
│ └── local-lib.
jar #
本地JAR存放位置
├── src/
└──
pom.xml # 配置依赖和插件
```
执行 `
mvn clean package` 后，在 `target/` 目录
生成的
JAR 文件将
包含所有
本地依赖。
Maven安装自定义Jar包
本文介绍如何从mvnrepository.com下载所需Jar包，并通过Maven命令进行本地安装。步骤包括搜索下载Jar包及使用Maven命令完成安装。
扫一扫
868
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
