在日常開發過程中，我們有時會遇到一些未上傳到 Maven 中央倉庫或公司私有倉庫的 JAR 包，比如第三方提供的 SDK 或自己編譯的庫。這時候，我們就需要將這些 JAR 包手動引入到 Maven 項目中。本文將介紹兩種常見方式：將 JAR 安裝到本地倉庫（推薦）和使用 system 作用域直接引用。

方法一：使用 mvn install:install-file 安裝到本地倉庫（推薦）

這是最推薦的方式，它能夠最大程度保持 Maven 項目的整潔性與可維護性。

操作步驟：

1. 打開命令行工具。

2. 執行以下命令，將本地 JAR 包安裝到 Maven 的本地倉庫中：

mvn install:install-file \-Dfile=/path/to/your.jar \-DgroupId=com.example \-DartifactId=your-artifact \-Dversion=1.0.0 \-Dpackaging=jar

請將 /path/to/your.jar 替換為你的 JAR 包實際路徑。

1. 在 pom.xml 中添加依賴：

<dependency><groupId>com.example</groupId><artifactId>your-artifact</artifactId><version>1.0.0</version>
</dependency>

優點：

• 與其他依賴使用方式一致；

• 支持依賴傳遞；

• 更適合多人協作和構建工具集成；

• 可以結合私服進一步發布。

方法二：使用 system 作用域直接引用本地路徑（不推薦）

此方法不需要安裝到本地倉庫，直接在 pom.xml 中配置 JAR 包的路徑。

示例配置：

<dependency><groupId>com.example</groupId><artifactId>your-artifact</artifactId><version>1.0.0</version><scope>system</scope><systemPath>${project.basedir}/lib/your.jar</systemPath>
</dependency>

注意：${project.basedir} 表示項目根目錄，推薦將 JAR 包放在 lib 目錄中統一管理。

缺點：

• 無法參與依賴傳遞；

• 路徑硬編碼，不利于跨平臺、多人協作；

• Maven 官方不推薦使用。

總結

方法	推薦程度	特點
install-file 安裝到本地倉庫	?????	規范、支持依賴傳遞、適合長期使用
system 作用域引用	??	簡單快捷，但不規范、不推薦

建議優先使用 install-file 的方式管理本地 JAR，既可以保持項目結構清晰，又方便團隊協作和持續集成。如需管理多個本地 JAR，也可以考慮搭建私有 Maven 倉庫進行集中管理。