如何将本地 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 文件放在同一个文件夹下：

@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 文件所在目录，逐条执行以下命令：

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

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 中添加以下内容：

<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 包，尤其适合闭源或商业库的集成。