咨询Maven快速添加本地libs文件夹Jar包依赖的方法

我的Java项目里有个/libs文件夹，里面大概100个Jar包，几乎都不在官方Maven仓库里。目前用Eclipse手动把整个文件夹加到类路径能正常编译运行，但用Maven打包jar-with-dependencies时，Maven识别不了这个文件夹。知道可以用mvn install:install-file逐个导入本地仓库，但要挨个查Jar包的groupId和artifactId，太费时间。

3.1 有没有简便方法让Maven直接引入整个/libs文件夹的Jar包？ #

有两个快速方案，不用严格遵守Maven的依赖规范：

• 用system scope配合插件批量引入：在pom.xml里配置依赖集合指向/libs下的所有Jar包，再通过插件把这些Jar包打包进最终产物。示例配置：

<dependencies>
    <dependency>
        <groupId>local.libs</groupId>
        <artifactId>local-all</artifactId>
        <version>1.0</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/libs/*.jar</systemPath>
        <type>pom</type>
    </dependency>
</dependencies>

<build>
    <plugins>
        <!-- 把system scope的Jar包复制到打包目录 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>3.6.0</version>
            <executions>
                <execution>
                    <id>copy-system-libs</id>
                    <phase>prepare-package</phase>
                    <goals>
                        <goal>copy-dependencies</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.directory}/classes/lib</outputDirectory>
                        <includeScope>system</includeScope>
                    </configuration>
                </execution>
            </executions>
        </plugin>
        <!-- 打包时把libs目录的Jar包包含进去 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.6.0</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                    <configuration>
                        <descriptorRefs>
                            <descriptorRef>jar-with-dependencies</descriptorRef>
                        </descriptorRefs>
                        <archive>
                            <manifest>
                                <mainClass>你的主类全路径</mainClass>
                            </manifest>
                        </archive>
                        <includes>
                            <include>${project.basedir}/libs/*.jar</include>
                        </includes>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

• 用addjars-maven-plugin一键扫描导入：这个插件可以直接扫描指定文件夹下的所有Jar包并自动添加为依赖，无需手动配置每个Jar。pom.xml配置如下：

<build>
    <plugins>
        <plugin>
            <groupId>com.googlecode.addjars-maven-plugin</groupId>
            <artifactId>addjars-maven-plugin</artifactId>
            <version>1.0.5</version>
            <executions>
                <execution>
                    <goals>
                        <goal>add-jars</goal>
                    </goals>
                    <configuration>
                        <resources>
                            <resource>
                                <directory>${project.basedir}/libs</directory>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

配置后，Maven编译、打包时都会自动识别/libs下的所有Jar包，省心很多。

3.2 有没有更快的Jar包本地仓库导入方式？ #

可以写脚本批量自动导入，不用手动查每个Jar的信息：

• Shell脚本（Linux/Mac）：遍历/libs下的Jar包，尝试从MANIFEST.MF里提取artifactId和version，提取不到就用Jar包名和默认版本，统一用local.group作为groupId：

#!/bin/bash
LIBS_DIR="./libs"

for JAR_FILE in "$LIBS_DIR"/*.jar; do
    # 从MANIFEST提取实现名称和版本
    ARTIFACT_ID=$(unzip -p "$JAR_FILE" META-INF/MANIFEST.MF | grep -i "Implementation-Title" | awk -F ": " '{print $2}' | tr ' ' '-')
    VERSION=$(unzip -p "$JAR_FILE" META-INF/MANIFEST.MF | grep -i "Implementation-Version" | awk -F ": " '{print $2}')

    # 提取失败时用Jar包名和默认版本
    if [ -z "$ARTIFACT_ID" ]; then
        ARTIFACT_ID=$(basename "$JAR_FILE" .jar)
    fi
    if [ -z "$VERSION" ]; then
        VERSION="1.0"
    fi

    # 导入本地仓库
    mvn install:install-file -Dfile="$JAR_FILE" -DgroupId=local.group -DartifactId="$ARTIFACT_ID" -Dversion="$VERSION" -Dpackaging=jar
done

• Batch脚本（Windows）：逻辑类似，用命令行工具提取信息（需要提前安装7z等解压工具）：

@echo off
set LIBS_DIR=.\libs

for %%f in (%LIBS_DIR%\*.jar) do (
    :: 提取Jar包名作为artifactId
    set ARTIFACT_ID=%%~nf
    set VERSION=1.0

    :: 尝试从MANIFEST提取版本
    7z e -so "%%f" META-INF/MANIFEST.MF | findstr /i "Implementation-Version" > temp.txt
    if not errorlevel 1 (
        set /p VERSION=<temp.txt
        set VERSION=!VERSION:*: =!
    )

    :: 导入本地仓库
    mvn install:install-file -Dfile="%%f" -DgroupId=local.group -DartifactId=!ARTIFACT_ID! -Dversion=!VERSION! -Dpackaging=jar
)
del temp.txt

运行脚本后，所有Jar包会自动导入本地Maven仓库，之后就能像普通依赖一样在pom.xml里引用了。

内容的提问来源于stack exchange，提问作者Viktor Carlson