Maven命令安装本地JAR包：mvn install:install-file详细教程

在日常Java开发中，我们经常会遇到需要使用第三方JAR包的场景，尤其是一些未发布到Maven中央仓库的私有JAR包（比如本文中的海康威视Artemis HTTP客户端JAR）。这时候就需要通过Maven命令将本地JAR包安装到本地仓库，以便项目能够正常依赖引用。本文将详细解析命令的使用方法，以安装为例进行实操演示。

怪只怪满眼尽是人间烟火

977人浏览 · 2025-10-29 09:59:55

怪只怪满眼尽是人间烟火 · 2025-10-29 09:59:55 发布

在日常Java开发中，我们经常会遇到需要使用第三方JAR包的场景，尤其是一些未发布到Maven中央仓库的私有JAR包（比如本文中的海康威视Artemis HTTP客户端JAR）。这时候就需要通过Maven命令将本地JAR包安装到本地仓库，以便项目能够正常依赖引用。本文将详细解析 mvn install:install-file 命令的使用方法，以安装 artemis-http-client-1.1.13.RELEASE.jar 为例进行实操演示。

海康地址：https://open.hikvision.com/download/5c67f1e2f05948198c909700?type=10

一、命令用途说明

mvn install:install-file 是Maven提供的一个核心命令，用于将本地文件系统中的JAR包（或其他类型的构件）安装到Maven本地仓库（默认路径为 用户目录/.m2/repository）。安装完成后，项目的pom.xml文件就可以像依赖中央仓库的构件一样，通过groupId、artifactId和version来引用该本地JAR包。

二、命令各参数解析

本文要讲解的完整命令模板如下：

mvn install:install-file -DgroupId=com.hikvision.ga -DartifactId=artemis-http-client -Dversion=1.1.13.RELEASE -Dpackaging=jar -Dfile=本地JAR包路径

其中各-D参数的含义如下表所示：

参数名	必填性	含义说明	本文示例值
`-DgroupId`	是	组织ID，用于标识构件的所属组织或公司，通常采用反向域名的形式（如com.hikvision.ga代表海康威视的某个部门）	com.hikvision.ga
`-DartifactId`	是	构件ID，用于标识具体的项目或模块，是构件在组织下的唯一标识	artemis-http-client
`-Dversion`	是	构件版本号，用于区分不同版本的构件，通常格式为X.Y.Z.RELEASE（稳定版）或SNAPSHOT（快照版）	1.1.13.RELEASE
`-Dpackaging`	是	构件的打包类型，此处为JAR包，所以值为`jar`（其他常见类型还有war、pom等）	jar
`-Dfile`	是	本地JAR包的绝对路径或相对路径（相对当前命令执行目录），必须准确指向JAR文件	E:\libs\artemis-http-client-1.1.15.RELEASE.jar（示例路径）

三、实操步骤详解

步骤1：准备本地JAR包

首先需要获取目标JAR包（如artemis-http-client-1.1.15.RELEASE.jar），可以从第三方厂商官网（如海康威视开放平台）下载，或从其他项目中复制。将JAR包保存到本地某个路径下，例如E:\libs\目录，此时JAR包的完整路径为E:\libs\artemis-http-client-1.1.15.RELEASE.jar。