在开发过程中，有时候我们会碰到需要在 Maven 项目里引入本地 JAR 包的情况。下面就给大家详细介绍三种正确引入本地 JAR 包的方式，并对比它们的优缺点。
一、使用 system 范围依赖
1. 应用场景
当我们有一些本地的 JAR 包，这些包可能是公司内部开发的，或者是从第三方下载的但没有发布到 Maven 仓库的，就可以使用这种方式引入。比如，公司内部有一个加密算法的 JAR 包，没有对外公开，只能在公司内部使用，这时就可以用 system 范围依赖引入到项目中。
2. 示例（Java 技术栈）
<project>
<!-- 项目基本信息 -->
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>my-project</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<!-- 使用 system 范围依赖引入本地 JAR 包 -->
<dependency>
<groupId>com.example</groupId>
<artifactId>local-library</artifactId>
<version>1.0</version>
<!-- 指定依赖范围为 system -->
<scope>system</scope>
<!-- 指定本地 JAR 包的路径 -->
<systemPath>${basedir}/lib/local-library.jar</systemPath>
</dependency>
</dependencies>
</project>
在这个示例中，${basedir} 表示项目的根目录，lib 是存放本地 JAR 包的文件夹，local-library.jar 就是我们要引入的本地 JAR 包。
3. 技术优缺点
- 优点：简单直接，只需要在
pom.xml里指定本地 JAR 包的路径就可以引入。 - 缺点：这种方式引入的 JAR 包不会被打包到项目的最终构建产物中，而且在不同的开发环境中，本地 JAR 包的路径可能不同，需要手动修改
systemPath。
4. 注意事项
- 要确保本地 JAR 包的路径是正确的，不然会导致依赖引入失败。
- 在不同的开发环境中，要注意本地 JAR 包的路径是否一致。
二、安装本地 JAR 包到本地 Maven 仓库
1. 应用场景
当我们需要在多个 Maven 项目中使用同一个本地 JAR 包时，就可以把这个 JAR 包安装到本地 Maven 仓库。比如，公司有一个公共的工具类 JAR 包，多个项目都需要使用，就可以把它安装到本地 Maven 仓库，这样每个项目都可以通过 Maven 依赖来引入。
2. 示例（Java 技术栈）
第一步：安装本地 JAR 包到本地 Maven 仓库
mvn install:install-file -Dfile=path/to/local-library.jar -DgroupId=com.example -DartifactId=local-library -Dversion=1.0 -Dpackaging=jar
-Dfile：指定本地 JAR 包的路径。-DgroupId、-DartifactId、-Dversion：指定 JAR 包的坐标，方便在pom.xml中引用。-Dpackaging：指定 JAR 包的打包类型。
第二步：在 pom.xml 中引入依赖
<project>
<!-- 项目基本信息 -->
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>my-project</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<!-- 引入安装到本地 Maven 仓库的 JAR 包 -->
<dependency>
<groupId>com.example</groupId>
<artifactId>local-library</artifactId>
<version>1.0</version>
</dependency>
</dependencies>
</project>
3. 技术优缺点
- 优点：安装到本地 Maven 仓库后，多个项目都可以方便地引用这个 JAR 包，而且 JAR 包会被正确地打包到项目的最终构建产物中。
- 缺点：需要手动执行安装命令，比较麻烦，而且如果 JAR 包有更新，需要重新安装。
4. 注意事项
- 安装 JAR 包时，要确保
groupId、artifactId、version等信息的准确性，不然在pom.xml中引用时会找不到依赖。 - 如果 JAR 包有更新，要及时重新安装到本地 Maven 仓库。
三、搭建本地 Maven 仓库
1. 应用场景
当公司内部有很多本地 JAR 包，而且多个项目都需要使用这些 JAR 包时，搭建一个本地 Maven 仓库是一个很好的选择。这样可以方便管理和共享这些本地 JAR 包。
2. 示例（Java 技术栈）
第一步：搭建本地 Maven 仓库
可以使用 Nexus 来搭建本地 Maven 仓库，这里简单介绍一下搭建步骤：
- 下载 Nexus 安装包并解压。
- 启动 Nexus 服务。
- 配置 Nexus 仓库，创建一个本地仓库用于存放本地 JAR 包。
第二步：将本地 JAR 包上传到本地 Maven 仓库
mvn deploy:deploy-file -Dfile=path/to/local-library.jar -DgroupId=com.example -DartifactId=local-library -Dversion=1.0 -Dpackaging=jar -Durl=http://localhost:8081/repository/maven-releases/ -DrepositoryId=nexus-releases
-Durl：指定本地 Maven 仓库的地址。-DrepositoryId：指定仓库的 ID。
第三步：在 pom.xml 中配置本地 Maven 仓库并引入依赖
<project>
<!-- 项目基本信息 -->
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>my-project</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- 配置本地 Maven 仓库 -->
<repositories>
<repository>
<id>nexus-releases</id>
<url>http://localhost:8081/repository/maven-releases/</url>
</repository>
</repositories>
<dependencies>
<!-- 引入存放在本地 Maven 仓库的 JAR 包 -->
<dependency>
<groupId>com.example</groupId>
<artifactId>local-library</artifactId>
<version>1.0</version>
</dependency>
</dependencies>
</project>
3. 技术优缺点
- 优点：方便管理和共享本地 JAR 包，多个项目可以统一从本地 Maven 仓库获取依赖，而且可以对 JAR 包进行版本控制。
- 缺点：搭建和维护本地 Maven 仓库需要一定的技术成本，而且需要占用一定的服务器资源。
4. 注意事项
- 搭建本地 Maven 仓库时，要确保服务器的稳定性和安全性。
- 上传 JAR 包时，要确保
groupId、artifactId、version等信息的准确性。
四、三种方式的对比总结
1. 适用场景对比
- system 范围依赖：适用于临时引入本地 JAR 包，不考虑打包和共享的情况。
- 安装本地 JAR 包到本地 Maven 仓库：适用于多个项目需要使用同一个本地 JAR 包的情况。
- 搭建本地 Maven 仓库：适用于公司内部有大量本地 JAR 包需要管理和共享的情况。
2. 优缺点对比
| 方式 | 优点 | 缺点 |
|---|---|---|
| system 范围依赖 | 简单直接 | 不打包，路径依赖 |
| 安装本地 JAR 包到本地 Maven 仓库 | 方便多个项目引用，正确打包 | 手动安装，更新麻烦 |
| 搭建本地 Maven 仓库 | 方便管理和共享，版本控制 | 技术成本高，占用资源 |
3. 选择建议
- 如果只是临时引入一个本地 JAR 包，而且不需要考虑打包和共享，那么可以选择 system 范围依赖。
- 如果有多个项目需要使用同一个本地 JAR 包，那么可以选择安装本地 JAR 包到本地 Maven 仓库。
- 如果公司内部有大量本地 JAR 包需要管理和共享，那么搭建本地 Maven 仓库是一个更好的选择。
评论