如何将本地 Jar 包安装到 Maven 仓库（以 Aspose 为例）

在实际开发中，我们经常会遇到一些第三方库（如商业库 Aspose）无法通过 Maven 仓库直接引入的情况。这时，我们可以手动将 jar 包安装到本地 Maven 仓库，然后像普通依赖一样使用它。

本文以 Aspose.Slides 和 Aspose.Words 为例，手把手教你如何将 jar 包添加到本地 Maven 仓库并在项目中使用。

🎯 前置条件

你已经安装并配置好 JDK 和 Maven（确保 mvn 命令可用）
你已经获得需要的 jar 包文件，比如：
- aspose-slides-19.3.jar
- aspose-words-15.8.0-jdk16.jar

📦 第一步：安装 jar 到本地 Maven 仓库

你有 两种方式 来完成这一步：推荐使用脚本方式 ，也支持手动执行命令。

✅ 方法一：使用 .bat 脚本（推荐）

将以下内容保存为 install-aspose.bat，并与两个 jar 文件放在同一个文件夹下：

bat 复制代码

@echo off
echo ============================================
echo Installing Aspose JARs to local Maven repository...
echo ============================================

echo Installing aspose-slides-19.3.jar...
mvn -N install:install-file -Dfile="aspose-slides-19.3.jar" -DgroupId=aspose -DartifactId=aspose-slides -Dversion=19.3 -Dpackaging=jar -DcreateChecksum=true
echo.

echo Installing aspose-words-15.8.0-jdk16.jar...
mvn -N install:install-file -Dfile="aspose-words-15.8.0-jdk16.jar" -DgroupId=aspose -DartifactId=aspose-words -Dversion=15.8.0 -Dpackaging=jar -DcreateChecksum=true
echo.

echo ============================================
echo Done. Both JARs should now be in your .m2 repository.
pause

✅ 双击运行该文件即可自动安装。

✅ 方法二：单独执行命令（适合初学者理解每一步）

你也可以打开命令提示符（cmd）或 PowerShell，进入 jar 文件所在目录，逐条执行以下命令：

bash 复制代码

mvn -N install:install-file -Dfile="aspose-slides-19.3.jar" -DgroupId=aspose -DartifactId=aspose-slides -Dversion=19.3 -Dpackaging=jar -DcreateChecksum=true

bash 复制代码

mvn -N install:install-file -Dfile="aspose-words-15.8.0-jdk16.jar" -DgroupId=aspose -DartifactId=aspose-words -Dversion=15.8.0 -Dpackaging=jar -DcreateChecksum=true

-Dfile=... 指定 jar 文件路径
-DgroupId/artifactId/version 指定 Maven 依赖信息
-N 表示忽略当前目录是否是 Maven 项目
-DcreateChecksum=true 可选，会生成 .sha1 校验文件

🗃️ 第二步：验证文件是否成功安装

默认情况下，jar 文件会被安装到你本机的 .m2 仓库目录，例如：

复制代码

C:\Users\<你的用户名>\.m2\repository\aspose\aspose-slides\19.3\
C:\Users\<你的用户名>\.m2\repository\aspose\aspose-words\15.8.0\

每个目录下都应包含 jar 包和自动生成的 .pom 文件。

🧩 第三步：在 `pom.xml` 中引用依赖

现在你可以像使用普通依赖一样，在你的 Maven 项目的 pom.xml 中添加以下内容：

xml 复制代码

<dependency>
    <groupId>aspose</groupId>
    <artifactId>aspose-slides</artifactId>
    <version>19.3</version>
</dependency>

<dependency>
    <groupId>aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>15.8.0</version>
</dependency>

🛠️ 常见问题解答

❓ 运行 `mvn install:install-file` 报错：

复制代码

The goal you specified requires a project to execute but there is no POM...

✅ 解决：加上 -N 参数（mvn -N install:install-file），表示不依赖于当前目录是否为 Maven 项目。

✅ 总结

步骤	内容
1️⃣	准备好 jar 文件和 `.bat` 安装脚本
2️⃣	使用 `mvn install:install-file` 安装到本地仓库
3️⃣	在 `pom.xml` 中引用即可

这种方法适用于所有无法通过远程仓库下载的 jar 包，尤其适合闭源或商业库的集成。