JAR包在classpath中：如何在2025年从文件夹中导入所有库

引言：数千个JAR包的诅咒

您是否曾经遇到过这样的情况：您的Java项目不断膨胀，而lib/文件夹变成了一个由数十甚至数百个JAR文件组成的真正“动物园”？每次启动应用程序时，您都痛苦地回忆到底添加了哪个JAR包，又忘记了哪个？听起来很熟悉，不是吗？

"将目录中的所有jar包包含到Java classpath中"这个问题是Stack Overflow上最热门的问题之一。这并非没有原因。看似简单的任务，如果不知道正确的工具，就会变成令人头疼的问题。在本文中，我们将分析所有方法：从古老得像恐龙一样的方法，到2025年每位受人尊敬的Java开发者都会使用的最现代方法。

准备好了，我们将踏上一段穿越classpath丛林的激动人心之旅！

为什么这本身是个问题？（或“-cp的史诗”）

在美好的旧时光（Java 6之前），开发者不得不手动列出每个JAR文件。大致如下：

java -cp lib/guava.jar:lib/spring-core.jar:lib/log4j.jar:lib/jackson.jar MyApp

现在想象一下，您有30个库。一个拼写错误——应用程序就会因ClassNotFoundException而崩溃。噩梦！正是在那时，社区开始寻找如何用一行代码将所有的jar包导入Java classpath的方法。

方法一：通配符——来自Java 6的救星

从Java 6开始，JVM中出现了一个神奇的功能——通配符。您只需指定带有星号的文件夹路径，JVM就会自动从那里加载所有JAR文件。

工作原理如下：

java -cp "lib/*" MyApp

重要！请注意引号。如果没有引号，在某些shell中（例如Unix），星号可能会被shell解释，您将得到意想不到的结果。引号确保*被正确地传递给JVM。

这种方法至今仍然有效。它简单、优雅，能解决90%的问题。但有一个细微之处：通配符不支持递归。如果您有嵌套文件夹（lib/subdir/），其中的内容不会被加载。为此，您需要手动指定每一层：

java -cp "lib/*:lib/subdir/*" MyApp

何时使用通配符？

\n
• 您正在编写一个简单的脚本或工具。
\n
• 您没有构建系统（Maven/Gradle）。
\n
• 您需要快速“临时”启动某些东西。
\n

方法二：Maven——行业标准

如果您在开发一个实际项目，您很可能使用Maven。而“如何从文件夹中包含所有JAR包”这个问题在构建层面就得到了解决。

Maven自行管理依赖项。您只需在pom.xml中指定它们，Maven就会下载所需的JAR包并自动将它们添加到classpath中。

pom.xml示例：

<dependencies>\n    <dependency>\n        <groupId>org.springframework.boot</groupId>\n        <artifactId>spring-boot-starter-web</artifactId>\n        <version>3.2.0</version>\n    </dependency>\n    <dependency>\n        <groupId>com.google.code.gson</groupId>\n        <artifactId>gson</artifactId>\n        <version>2.10.1</version>\n    </dependency>\n</dependencies>

在构建时（例如mvn package），Maven会创建一个fat JAR（或使用maven-dependency-plugin插件），其中包含所有依赖项。您不再需要考虑classpath——它已经被打包在里面了。

但是，如果您需要从某个不受Maven管理的本地文件夹中导入所有JAR包，该怎么办？为此，有系统依赖项（尽管这被认为是一种反模式）：

<dependency>\n    <groupId>com.example&